home *** CD-ROM | disk | FTP | other *** search
/ Network Supervisor's Toolkit / Network Supervisor's Toolkit.iso / editors / aurora / a.doc < prev    next >
Encoding:
Text File  |  1996-07-10  |  226.9 KB  |  5,722 lines
  1.  
  2.  
  3.  
  4.   T h e   A u r o r a   E d i t o r   U s e r ' s   G u i d e
  5.   ───────────────────────────────────────────────────────────
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.   The Aurora Editor User's Guide
  16.  
  17.   Version 1.20, January 1994
  18.  
  19.   Copyright (c) 1993-1994 Aurora Terra, Inc.
  20.  
  21.   ALL RIGHTS RESERVED.
  22.  
  23.  
  24.  
  25.  
  26.  
  27.   Aurora Terra, Inc.
  28.   P.O. Box 34275
  29.   Bethesda, MD. 20827-0275  USA
  30.   301-468-2255  (Voice)
  31.   301-230-1214  (BBS 14,400 V.32bis)
  32.  
  33.  
  34.  
  35.   The Aurora Editor is Copyright (c) 1993-1994 by Aurora Terra, Inc.
  36.   The Aurora Editor/386 is Copyright (c) 1993-1994 by Aurora Terra, Inc.
  37.   The Aurora Macro Language is Copyright (c) 1993-1994 by Aurora Terra, Inc.
  38.  
  39.   No parts of The Aurora Editor software or this document may be copied
  40.   in part or in whole, except as provided by the License in the
  41.   following pages.
  42.  
  43.   This version of The Aurora Editor is NOT public domain or free
  44.   software, but is distributed as "shareware" for evaluation purposes
  45.   only. Please refer to the license information in the following pages.
  46.  
  47.   The Aurora Editor is a trademark of Aurora Terra, Inc.
  48.   The Aurora Editor/386 is a trademark of Aurora Terra, Inc.
  49.   The Aurora Macro Language is a trademark of Aurora Terra, Inc.
  50.  
  51.   Other product names found throughout this document are trademarks of
  52.   various companies.
  53.                                                             License   ii
  54.  
  55.  
  56.   Copyright and Proprietary Rights
  57.   ────────────────────────────────
  58.  
  59.   The Aurora Editor software is owned by Aurora Terra, Inc. and is
  60.   protected by United States copyright laws and international treaty
  61.   provisions. The Aurora Editor software contains valuable trade secrets
  62.   proprietary to Aurora Terra, Inc. You may not disassemble, decompile,
  63.   reverse engineer, or create any derivative works of the software for
  64.   any purpose other than making an adaptation to the software as a
  65.   normal step in configuring it for your own personal use.
  66.  
  67.  
  68.   License and Restrictions
  69.   ────────────────────────
  70.  
  71.   Aurora Terra grants individuals a limited license to use the shareware
  72.   version of The Aurora Editor for an evaluation period of up to 30 days
  73.   in order to determine if it suits their needs. Any other use of The
  74.   Aurora Editor, or use past the 30 day trial period requires the
  75.   individual to purchase a license from Aurora Terra.
  76.  
  77.   The Aurora Editor is not "public domain" or "free" software. If you
  78.   use it beyond the 30-day trial you MUST purchase a license.
  79.  
  80.   All users are granted a limited license to copy the shareware version
  81.   of The Aurora Editor for the sole purpose of allowing others to try
  82.   it, subject to the above as well as the following restrictions:
  83.  
  84.   - The Aurora Editor must be distributed in absolutely unmodified form
  85.     in its entirety, including all file names, program code,
  86.     documentation, and any related files. No other programs or files may
  87.     be included. The files may be distributed in a compressed or library
  88.     format.
  89.  
  90.   - The Aurora Editor may not be included in combination with any other
  91.     software or hardware product as an enticement or for any other
  92.     reason, without special permission from Aurora Terra.
  93.  
  94.   - No fee or payment may be charged or accepted for The Aurora Editor.
  95.  
  96.  
  97.   Electronic bulletin board system operators (sysops) are encouraged
  98.   post the shareware version of The Aurora Editor on their BBS for
  99.   downloading by their users, but only if the above conditions are met
  100.   and no special fee is charged to access The Aurora Editor files (a
  101.   general fee may be charged to access the BBS).
  102.  
  103.   Special restrictions apply to Disk Vendors and Retailers. For further
  104.   details, see VENDOR.DOC.
  105.                                                           Warranty   iii
  106.  
  107.  
  108.   Non-profit User Groups may distribute the shareware version of The
  109.   Aurora Editor provided the above conditions are met. These User Groups
  110.   may charge a nominal fee to cover the cost of the disk and copying of
  111.   the software.
  112.  
  113.  
  114.   Warranty Disclaimer
  115.   ───────────────────
  116.  
  117.   Aurora Terra makes no warranty of any kind, either express or implied,
  118.   including but not limited to implied warranties of merchantability and
  119.   fitness for a particular purpose, with respect to this software and
  120.   accompanying documentation.
  121.  
  122.   IN NO EVENT SHALL AURORA TERRA BE LIABLE FOR ANY DAMAGES RESULTING
  123.   FROM THE USE OF THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO, DAMAGES
  124.   FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS
  125.   INFORMATION, INCIDENTAL OR CONSEQUENTIAL DAMAGES, OR OTHER FINANCIAL
  126.   LOSS ARISING OUT OF THE USE OF OR INABILITY TO USE THIS PROGRAM, EVEN
  127.   IF AURORA TERRA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  128.  
  129.  
  130.   I-1  Ordering Information
  131.   ─────────────────────────
  132.  
  133.   Purchasing a license for (or registering) The Aurora Editor, allows
  134.   you to use the product beyond the 30-day trial period. With your
  135.   registration, you will receive the complete licensed version of The
  136.   Aurora Editor with all the latest enhancements.
  137.  
  138.   Registration also entitles you to free lifetime technical support,
  139.   free and discounted upgrades, priority notification on major new
  140.   updates and releases, and access to registered user area of the
  141.   Aurora Support BBS at 301-230-1214 <8,N,1>.
  142.  
  143.   Registration costs just $44.95 plus $2 shipping ($4 overseas). For a
  144.   printed bound manual, add $10.00 plus $2 extra shipping ($5 overseas).
  145.   Maryland residents add 5% sales tax. Please register now, and help us
  146.   continue to make high quality software available to you at a low cost.
  147.  
  148.   Discounts are available for BBS sysops, educational institutions,
  149.   full-time students, US government agencies, and approved user groups.
  150.   We also offer quantity discounts and site (multi-user) licensing.
  151.   Please call or write for more information.
  152.                                                            Ordering   iv
  153.  
  154.  
  155.   For Checks, Money Orders, or Corporate Purchase Orders:
  156.  
  157.     Please Send Check, Money Order, or Corporate Purchase Order to:
  158.     Aurora Terra, P.O. Box 34275, Bethesda, MD. 20827-0275. Checks must
  159.     be drawn on a US bank and payable in US dollars.
  160.  
  161.  
  162.   For Credit Card Orders only:
  163.  
  164.     You can order The Aurora Editor with VISA, MasterCard, AMEX, or
  165.     Discover from Public (software) Library by calling 800-2424-PsL or
  166.     713-524-6394, or by FAX to 713-524-6398, or Compuserve Email to
  167.     71355,470. Please specify item #10917. You can also mail credit card
  168.     orders to PsL at P.O. Box 35705, Houston, TX 77235-5705 USA.
  169.  
  170.  
  171.   For questions about registration, product details, technical support,
  172.   discounts, or other inquiries, call Aurora Terra at 301-468-2255, or
  173.   write to: Aurora Terra, P.O. Box 34275, Bethesda, MD. 20827-0275, or
  174.   Compuserve Email to: 71702,1025 (internet:71702.1025@compuserve.com).
  175.   The Aurora Support BBS is also available 24hrs/day at 301-230-1214 at
  176.   speeds up to 14,400 bps.
  177.  
  178.   You can use the following convenient order form if you wish:
  179.                                                           Order Form   v
  180.  
  181.   +----------------------------------------------------------------------+
  182.   |                                                                      |
  183.   | Aurora Terra, please send me:                          Item  #10917  |
  184.   |                                                                      |
  185.   |                                                                      |
  186.   | The Aurora Editor v1.20 ........................... $44.95  $______  |
  187.   |                                                                      |
  188.   | Printed Bound Manual ................................. $10  $______  |
  189.   |                                                                      |
  190.   | Shipping (US/Canada/Mexico) ......... $2  (with manual $4)           |
  191.   |          (Overseas) ................. $4  (with manual $9)  $______  |
  192.   |                                                                      |
  193.   |                                                 Subtotal 1  $______  |
  194.   |                                                                      |
  195.   |                                                x  Quantity   ______  |
  196.   |                                                                      |
  197.   |                                                 Subtotal 2  $______  |
  198.   |                                                                      |
  199.   | Maryland residents please add 5% Sales Tax ...............  $______  |
  200.   |                                                                      |
  201.   | Disk Type:  ( ) 5.25"   ( ) 3.5"                     TOTAL  $______  |
  202.   |                                                                      |
  203.   +----------------------------------------------------------------------+
  204.   |                                                                      |
  205.   | Name: _____________________________________________________________  |
  206.   |                                                                      |
  207.   | Company (if company address): _____________________________________  |
  208.   |                                                                      |
  209.   | Address: __________________________________________________________  |
  210.   |                                                                      |
  211.   |          __________________________________________________________  |
  212.   |                                                                      |
  213.   |          __________________________________________________________  |
  214.   |                                                                      |
  215.   | Phone (day): __________________   Phone (Evening): ________________  |
  216.   |                                                                      |
  217.   |                                                                      |
  218.   | Payment by:  ( ) Check/Money Order  ( ) PO#_______________ (attach)  |
  219.   |              ( ) VISA  ( ) MC  ( ) AMEX  ( ) DISCOVER                |
  220.   |                                                                      |
  221.   +----------------------------------------------------------------------+
  222.   |                                                                      |
  223.   | For Credit Card FAX or EMail Orders only:                            |
  224.   |                                                                      |
  225.   |   Card #______________________________________ Exp. Date:__________  |
  226.   |                                                                      |
  227.   |   Cardholder name:_________________________________________________  |
  228.   |                                                                      |
  229.   |   Signature:_______________________________________________________  |
  230.   |                                                                      |
  231.   |                                                                      |
  232.   | Prices are subject to change without notice. Call to confirm.        |
  233.   |                                                                      |
  234.   +----------------------------------------------------------------------+
  235.                                                                          
  236.  
  237.                                                   Table of Contents   vi
  238.  
  239.  
  240.   Table of Contents
  241.   ─────────────────
  242.  
  243.   I-1. Ordering Information..........................................iii
  244.   I-2. Acknowledgements.............................................viii
  245.   I-3. Introduction...................................................ix
  246.   I-4. Features........................................................x
  247.   I-5. Hardware and Software Requirements.............................xi
  248.   I-6. Installation..................................................xii
  249.   I-7. The Documentation............................................xiii
  250.  
  251.   1-1. Getting Started.................................................1
  252.  
  253.   2-1. Windows.........................................................2
  254.   2-2. Learning to use the Windows.....................................3
  255.   2-3. Panning the Screen..............................................6
  256.   2-4. Window Styles...................................................6
  257.   2-4. Window Styles...................................................6
  258.   2-5. Video Modes.....................................................7
  259.   2-6. Prompts.........................................................7
  260.  
  261.   3-1. Using the Menus................................................10
  262.  
  263.   4-1. The Status Line................................................12
  264.  
  265.   5-1. Creating and Loading Files.....................................13
  266.   5-2. Saving and Discarding Files....................................15
  267.   5-3. Other File Commands............................................18
  268.  
  269.   6-1. Finding Your Way Around........................................20
  270.   6-2. Scrolling......................................................25
  271.   6-3. Modifying Text.................................................26
  272.   6-4. Undo and Redo..................................................31
  273.  
  274.   7-1. OS Commands....................................................32
  275.  
  276.   8-1. Using Marked Blocks............................................34
  277.  
  278.   9-1. The Clipboard..................................................40
  279.  
  280.   10-1. Folding Text..................................................42
  281.  
  282.   11-1. Search and Replace............................................44
  283.  
  284.   12-1. Printing......................................................50
  285.  
  286.   13-1. Window Settings...............................................52
  287.   13-2. Global Settings...............................................55
  288.                                                  Table of Contents   vii
  289.  
  290.  
  291.   14-1. Key Macros....................................................59
  292.  
  293.   15-1. Other Commands................................................61
  294.   15-2. Miscellaneous Library Functions...............................62
  295.  
  296.   16-1. The File Manager..............................................66
  297.   16-2. Creating a File Manager Window................................67
  298.   16-3. Changing the Directory Listing in a File Manager Window.......68
  299.   16-4. File Manager Commands.........................................68
  300.   16-5. Marking Files in the File Manager.............................71
  301.   16-6. File Manager Sorting..........................................73
  302.  
  303.   17-1. Configuration.................................................73
  304.   17-2. Configuration - Video.........................................73
  305.   17-3. Configuration - Mouse.........................................74
  306.   17-4. Configuration - Word Processing...............................75
  307.   17-5. Configuration - Default File Extensions.......................76
  308.   17-6. Configuration - Open Options..................................77
  309.   17-7. Configuration - Save Options..................................79
  310.   17-8. Configuration - Editing Preferences...........................79
  311.   17-9. Configuration - Window Preferences............................86
  312.   17-10. Configuration - Print Settings...............................87
  313.   17-11. Configuration - Desktop Options..............................90
  314.   17-12. Configuration - Memory Options...............................91
  315.   17-13. Configuration - Other Options................................92
  316.   17-14. Configuration - Character Sets...............................93
  317.   17-15. Configuration - Text Translation.............................94
  318.   17-16. Configuration - Confirmations................................94
  319.   17-17. Configuration - Colors.......................................94
  320.   17-18. Configuration - Borders......................................95
  321.  
  322.   18-1. Redefining the Keyboard.......................................97
  323.   18-2. Key Function Names............................................98
  324.   18-3. Defining Compound Keys.......................................100
  325.   18-4. Mouse Function Names.........................................101
  326.   18-5. Defining Menus...............................................101
  327.   18-6. The Tool Bar.................................................103
  328.   18-7. Text Translation.............................................105
  329.  
  330.   A-1. Command Line Options..........................................107
  331.  
  332.   B-2. Performance Tips..............................................108
  333.  
  334.                                                  Acknowledgements   viii
  335.  
  336.  
  337.  
  338.   I-2  Acknowledgements
  339.   ─────────────────────
  340.  
  341.   Aurora has taken several years and thousands of hours to develop. Many
  342.   have contributed to this effort, but the following people deserve
  343.   special thanks:
  344.  
  345.   Stu Russell, for his endless patience and words of encouragement over
  346.   the years.
  347.  
  348.   Guy Rouillier, for his valuable support, suggestions, and advice.
  349.  
  350.   Jerry Cain, an "Aurora Activist" and sysop of The Edge of Forever BBS,
  351.   for his boundless enthusiasm and help in promoting this program.
  352.  
  353.                                                        Introduction   ix
  354.  
  355.  
  356.   I-3  Introduction
  357.   ─────────────────
  358.  
  359.   The Aurora Editor is a powerful and beautiful general-purpose text
  360.   editor for IBMPC and compatible computers. Although The Aurora Editor
  361.   is primarily oriented toward editing text files, program source, and
  362.   binary files, it can also be easily used for Word Processing and File
  363.   Management tasks. The evaluation copy is fully functional.
  364.  
  365.   Many people who use computers spend a large portion of their time in a
  366.   text editor. A text editor should be an attractive and fun place to
  367.   be. It should be fast, flexible, and intuitive, with the power to
  368.   provide almost any editing function needed. Limits should seldom be a
  369.   concern. It should "feel good" to be there. The Aurora Editor was
  370.   designed with all these goals in mind.
  371.  
  372.   The Aurora Editor is programmed in it's own macro language - "The
  373.   Aurora Macro Language". The Aurora Macro Language is an object
  374.   oriented, event-driven language that is very simple in syntax, yet
  375.   powerful in function. Both the macro language compiler and interpreter
  376.   are available as functions within the macro language itself. The
  377.   Aurora Macro Language can provide great flexibility in configuring the
  378.   editor to suit your needs.
  379.  
  380.   In its current form, The Aurora Editor is a very powerful and
  381.   sophisticated product. But it doesn't end there. The Aurora Editor is
  382.   an ongoing project and will continue to be enhanced in many important
  383.   and exciting new ways. Registering now entitles you to free upgrades,
  384.   and priority access to major releases.
  385.  
  386.  
  387.   I-4  Features
  388.   ─────────────
  389.  
  390.   These are just some of the outstanding features of The Aurora Editor:
  391.  
  392.   - High Performance! The screen, windows, file loading and saving, and
  393.     searching are all very fast.
  394.  
  395.   - Superb text mode windowing! Fast, beautiful, and seamless. Combines
  396.     the usability of graphical user interfaces with the speed of text
  397.     mode. Many different window styles. Edit any number of files. Edit
  398.     the same file in multiple windows, or different files in the same
  399.     window. Includes a 64k x 64k Virtual Screen!
  400.  
  401.   - Edits multiple files of virtually any size. A very fast, huge ONE
  402.     GIGABYTE paged virtual memory will satisfy even the most power
  403.     hungry user. Automatically uses XMS and EMS memory for even faster
  404.     editing of large files.
  405.                                                             Features   x
  406.  
  407.  
  408.   - A built-in sophisticated object-oriented macro language, "The Aurora
  409.     Macro Language", allows unparalleled flexibility in extending and
  410.     configuring the editor to your own preferences.
  411.  
  412.   - "The Aurora Editor/386", an even faster (and smaller) 386 version of
  413.     The Aurora Editor, is provided for users with 386 or greater
  414.     processors.
  415.  
  416.   - Full mouse support for moving and resizing windows, working with
  417.     menus and dialog boxes, scrolling, marking text, etc.
  418.  
  419.   - Includes an integrated multi-instance programmable File Manager. You
  420.     can perform most file management tasks without ever leaving the
  421.     editor.
  422.  
  423.   - Unlimited multi-level Undo/Redo of almost all editing operations.
  424.  
  425.   - Nested Text Folding, a rare and useful feature.
  426.  
  427.   - Maximum line length of 16000.
  428.  
  429.   - Supports binary viewing and editing using any line length up to
  430.     16000.
  431.  
  432.   - Supports any 1 or 2 character line delimiters (CR, CRLF, LF, and
  433.     more).
  434.  
  435.   - Executes DOS commands and programs from within the editor. The
  436.     editor shrinks down to only 1.2K.
  437.  
  438.   - User-definable menus, tool bar, keyboard, window appearances, and
  439.     editing preferences.
  440.  
  441.   - Tailored prompts. Includes Dialog boxes for first-time users, and
  442.     single-line command prompts for experienced users.
  443.  
  444.   - User-definable Text Translation automatically expands abbreviations
  445.     and corrects typos as you enter characters into your text.
  446.  
  447.   - Grep-type file scan
  448.  
  449.   - Unlimited Bookmarks
  450.  
  451.   - Compiler support for Microsoft C, Borland C, and Turbo Pascal. Jump
  452.     instantly to compiler errors in your source code.
  453.  
  454.   - Prompt History
  455.  
  456.   - Automatically remembers previous windows positions, cursor positions,
  457.     and desktop on exit. A real time saver.
  458.  
  459.   - A full set of Block commands
  460.                                                        Requirements   xi
  461.  
  462.  
  463.   - Unlimited number of Clipboards
  464.  
  465.   - Formatted Printing with Headers, Footers, Page Numbers and Line
  466.     Numbers.
  467.  
  468.   - Online Help
  469.  
  470.   - Keyboard Macros
  471.  
  472.   - Word wrap, AutoIndent, and Paragraph Text Reflow
  473.  
  474.   - Multiple default file extensions
  475.  
  476.   - Many other features: multiple video modes, line-drawing, ascii
  477.     chart, highlighting of modified lines, and much more!
  478.  
  479.  
  480.   I-5  Hardware and Software Requirements
  481.   ───────────────────────────────────────
  482.  
  483.   To use The Aurora Editor you will need an IBMPC or compatible computer
  484.   with at least the following:
  485.  
  486.     - 512 kilobytes of memory
  487.     - at least 600 kilobytes of hard disk space
  488.     - a diskette drive
  489.     - A color or monochrome monitor
  490.     - DOS 3.1 or greater
  491.     - The Aurora Editor v1.20
  492.  
  493.   A 286 or above processor is recommended.
  494.  
  495.  
  496.  
  497.   I-6  Installation
  498.   ─────────────────
  499.  
  500.   Before using or installing The Aurora Editor, it is very important
  501.   that you take a moment to backup all of the distributed files. If you
  502.   do not backup, there will be no way to restore the original
  503.   configuration files if you modify them.
  504.  
  505.   To install The Aurora Editor, just copy the files from the
  506.   distribution diskette(s) to the drive and directory of your choice,
  507.   and uncompress them if they are compressed. Add this directory to your
  508.   DOS 'PATH' for easier access to The Aurora Editor.
  509.  
  510.                                                       Installation   xii
  511.  
  512.  
  513.   The following files are distributed with The Aurora Editor:
  514.  
  515.     Executable Files:
  516.       A.EXE     - The Aurora Editor (Macro Language Interpreter/Compiler)
  517.       A3.EXE    - The Aurora Editor/386 (Macro Language Interpreter/Compiler)
  518.       A.X       - compiled macro code for The Aurora Editor
  519.  
  520.     Macro Source and Libraries:
  521.       A.A       - the main macro source file for The Aurora Editor
  522.       ACFG.A    - configuration settings (included by A.A)
  523.       AKBD.A    - keyboard and mouse definitions (included by A.A)
  524.       AMEN.A    - menu definitions (included by A.A)
  525.       ATRN.A    - text translation definition table & macros
  526.       ALIB.X    - compiled macro library code (included by A.A)
  527.  
  528.     Documentation:
  529.       A.DOC     - The Aurora Editor Users Guide (this document)
  530.       AML.DOC   - The Aurora Macro Language Guide
  531.       AREF.DOC  - The Aurora Editor Quick Reference
  532.       READ.ME   - New features and other information
  533.  
  534.  
  535.   I-7  The Documentation
  536.   ──────────────────────
  537.  
  538.   This is "The Aurora Editor Users Guide". It provides basic information
  539.   on how to install, configure, and use The Aurora Editor. For complete
  540.   documentation on The Aurora Macro Language, see "The Aurora Macro
  541.   Language Guide" (AML.DOC).
  542.  
  543.   If you are viewing this document with The Aurora Editor, you can use
  544.   the "Help" pull-down menu <F1> to jump quickly to any topic in the
  545.   document. You can print this document using the DOS "print" command.
  546.  
  547.   Aurora is a highly configurable editor. Please note that most key and
  548.   mouse definitions, menu definitions, and configuration settings used
  549.   in this documentation are installation defaults. You can customize
  550.   most of these definitions and settings to according to your own
  551.   preferences.
  552.  
  553.   The File ALIB.X contains many compiled editor commands written in The
  554.   Aurora Macro Language. These editor commands are referred to as
  555.   "library functions", and can be used in the Keyboard Definitions file
  556.   AKBD.A, the Menu Definitions file AMEN.A, the Text Translation
  557.   definitions file ATRN.A, and the Macro Command prompt. All library
  558.   functions are generally available for use within The Aurora Macro
  559.   Language. This documentation explains each of these library functions
  560.   as "editor commands".
  561.                                                     Documentation   xiii
  562.  
  563.  
  564.   Editor commands are generally listed in the following format
  565.   throughout the User's Guide:
  566.  
  567.     - command  "Menu Description"  <key definition>
  568.  
  569.   For example, the command to display the "open" prompt is listed as:
  570.  
  571.     - askopen  "Open.."  <Alt-E>
  572.  
  573.   In some cases, command parameters may be included as part of the
  574.   command. Some commands do not have default key assignments at
  575.   installation time. For these commands, the "<key definition>" is
  576.   omitted. Also, some commands are not (by default) on the menus. For
  577.   these commands the "Menu Description" is omitted.
  578.  
  579.   Note that only "library" functions (editor commands) are documented
  580.   here in The Aurora Editor User's Guide. Library functions are built up
  581.   from lower-level macros and native functions in the Aurora Macro
  582.   Language and are usually all that is required for most editing tasks.
  583.   For documentation on macro language native functions, see "The Aurora
  584.   Macro Language Guide".
  585.                                                      Getting Started   1
  586.  
  587.  
  588.   1-1  Getting Started
  589.   ────────────────────
  590.  
  591.   To start The Aurora Editor, just type "A" at the DOS command prompt.
  592.   If you have computer with a 386 or greater processor, you can start
  593.   The Aurora Editor/386 by typing "A3" at the DOS command prompt.
  594.  
  595.     Note: If you prefer to start The Aurora Editor or The Aurora
  596.     Editor/386 by other names, you can rename the files A.EXE and A3.EXE
  597.     to whatever you wish (such as "E.EXE"). Make sure you keep the
  598.     ".EXE" extension. Do not rename any other files distributed with The
  599.     Aurora Editor. All distributed files must be in the same directory.
  600.  
  601.   If this is the first time you are using Aurora, a File Manager window
  602.   will be displayed showing all files in the current directory. To edit
  603.   a file, just use the cursor keys to position the highlighted bar over
  604.   a file and then press <Enter>. An Edit window will be displayed
  605.   showing the contents of the file.
  606.  
  607.   You can bypass the File Manager by entering a filename after the "A"
  608.   or "A3" command at the DOS prompt. For example:
  609.  
  610.     C>a newfile.txt
  611.  
  612.   When the Edit window is displayed, you are ready to begin editing. You
  613.   can now use the cursor movement keys, the <PgUp>, <PgDn>, <Home>, and
  614.   <End> keys, and the mouse (if available) to move through the text. You
  615.   can press <Esc> to activate the pull-down menu system and explore the
  616.   features of The Aurora Editor.
  617.  
  618.   If you need on-line help at any time, just press <F1> to display the
  619.   "Help" pull-down menu.
  620.  
  621.  
  622.   Exiting The Aurora Editor
  623.   ─────────────────────────
  624.  
  625.   To exit The Aurora Editor, keep pressing <Alt-Q> to close each window
  626.   you have opened. You can also close each window by clicking the left
  627.   mouse button on the "close" icon (≡) in the upper left corner of the
  628.   window, or by selecting "Close" from the "File" pull-down menu. If you
  629.   have not saved any changes, you will be prompted to save them.
  630.  
  631.   A quicker way to exit is to press <Alt-X>, or select "Close All" from
  632.   the File pull-down menu. This will automatically close all windows.
  633.   Again, you may be prompted to save any changes.
  634.                                                              Windows   2
  635.  
  636.  
  637.   2-1  Windows
  638.   ────────────
  639.  
  640.   The Aurora Editor provides a beautiful, intuitive windowing
  641.   environment that works well for both first-time and experienced users.
  642.   Windows are used to edit files, operate the File Manager, and display
  643.   prompts and dialog boxes. All windowing functions can be operated by
  644.   using the menus, the mouse, or user-defined function keys.
  645.  
  646.   A window in The Aurora Editor looks and behaves much like an
  647.   application window in Microsoft Windows, which allows for quick and
  648.   easy operation by most first-time users. When you become more familiar
  649.   with The Aurora Editor, you can even configure the window layout to
  650.   your own preferences (see "Window Styles" 2-4). Each window has a
  651.   "client area" (the main display area), and optional title bars, menus,
  652.   tool bars, scroll bars, and borders. The following is a sample Edit
  653.   window:
  654.  
  655.  
  656.     Close Icon       North Title Bar        Status Line      Tool Bar ─┐
  657.        │                   │                   │                       │
  658.        │    North Title    │      Menu Bar     │ Min/Max/Restore Icons │
  659.        │        │          │        │          │            │          │
  660.     ▒▒▒│▒▒░░░░░░│░░░░░░░░░░│░░░░░░░░│░░░░░░░░░░│░░░░░░░░░░░░│▒▒▒▒▒     │
  661.     ▒▒ ≡ C:\DOC\NEWDOC.TXT ┴  * [20]│ C 12  L 153  of 321  └  ▒▒     │
  662.     ▒▒ File  Window  Block  Search  Fold  Edit  Clip  Print  Set▒▒     │
  663.     ░░ <≡>  <?>  <*>  </>  <->  <|>  <o>  <s>  <F>  <f>  <r> ──────────┘
  664.     ░░                                                         ░░
  665.     ░░ This is the Edit window client area                     ▒───┐
  666.     ░░                                                         ■░░ │
  667.     ░░                                                         ▒░░ │
  668.     ░░                                                         ░░ │
  669.     ▒▒▒▒▒■▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  670.     ▒▒                           ┬          │   ┌─ Aurora v1.20 ▒▒ │
  671.     ▒▒▒▒▒▒░░░░░░░░░░░░░░░░░░░░░░░│░░░░░░░░░░│░░░│░░░░░░░░░░░▒▒▒▒▒▒ │
  672.       │             │            │          │   │                  │
  673.     Corner          │     South Title Bar   │  South Title         │
  674.                     │                       │                      │
  675.                   Border              Horz Scroll Bar    Vert Scroll Bar
  676.  
  677.  
  678.   For Edit windows, the file you are editing is displayed in the client
  679.   area. File Manager windows are similar in appearance to Edit windows,
  680.   but the client area displays a listing of files and directories (see
  681.   "The File Manager" 16-1).
  682.  
  683.   The Aurora Editor will allow any number of overlapping Edit windows
  684.   and File Manager windows to be arranged on top of each other in a
  685.   "messy desk" style on your screen.
  686.                                                               Windows  3
  687.  
  688.  
  689.   2-2  Learning to use the Windows
  690.   ────────────────────────────────
  691.  
  692.   Editor windows are easy to control with the mouse or the keyboard. You
  693.   can also execute most window commands from the "Window" pull-down on
  694.   the menu bar. The following are some important window commands:
  695.  
  696.   - to "activate" a window with the mouse:
  697.  
  698.     Using the mouse, you can click the left mouse button on any visible
  699.     portion of a window to bring the window to the top and make it the
  700.     current or "active" window.
  701.  
  702.   - wlis  "List.."  <Alt-W>
  703.  
  704.     This command displays a menu which lists all the Edit and File
  705.     Manager windows in your current session. To bring one of the
  706.     displayed windows to the top and make it the current window, use the
  707.     cursor keys to position the highlighted bar over the window name and
  708.     press <Enter>. You can also select the window from the list using
  709.     the left mouse button.
  710.  
  711.     Note: the window list can also be displayed by double-clicking the
  712.     left mouse button on the screen background.
  713.  
  714.   - quit %p  "Close"  <Alt-Q>
  715.  
  716.     This command closes the current window and removes it from the
  717.     screen. If you are closing an Edit window and you have made changes
  718.     which have not been saved, The Aurora Editor will prompt you to save
  719.     them. You can also close a window by clicking the left mouse button
  720.     on the "close" icon (≡) in the upper left corner of the window.
  721.  
  722.     If there is another window underneath the window you just closed,
  723.     that window will become the "current" window, otherwise you will
  724.     exit the editor.
  725.  
  726.   - wquit %p  <Ctrl-K-Q>
  727.  
  728.     This command closes the current window. If the window is an Edit
  729.     window and the "OneWindow" configuration setting is OFF, this
  730.     command also closes the file in the window (see "Configuration -
  731.     Editing Preferences" 17-8).
  732.  
  733.   - wnex  "Next"  <Ctrl-A>
  734.  
  735.     This command cycles through the windows in a forward direction. The
  736.     bottom-most window is placed on top of the current window and
  737.     becomes the current window.
  738.                                                              Windows   4
  739.  
  740.  
  741.   - wpre  "Prev"
  742.  
  743.     This command cycles through the windows in a reverse direction. The
  744.     window underneath the current window becomes the current window, and
  745.     the current window is moved underneath all other windows on the
  746.     screen.
  747.  
  748.  
  749.   Several commands can be used to move and resize windows:
  750.  
  751.   - to move or resize a window with the mouse:
  752.  
  753.     To move the window, position the mouse over the window's north or
  754.     south title bar and press the left mouse button. Then drag the
  755.     window to the new location and release the left mouse button.
  756.  
  757.     To resize the window, position the mouse over one of the window
  758.     borders or corners and press the left mouse button. Then drag the
  759.     border or corner to the new location and release the left mouse
  760.     button.
  761.  
  762.   - wkey  "Move/Size"  <Ctrl-F5>
  763.  
  764.     This command allows you to move and resize the current window using
  765.     the cursor keys. When this command is entered, the editor is placed
  766.     in "move/resize" mode, and the border of the current window is
  767.     highlighted to indicate that it is being moved or resized.
  768.  
  769.     To move the window, just press the cursor keys until the window has
  770.     moved to the desired position, and then press <Enter> or <Esc> to
  771.     stop.
  772.  
  773.     To resize the window, press the cursor keys while the <Shift> key is
  774.     pressed down. You can resize the left and bottom borders of the
  775.     window. Press <Enter> or <Esc> to stop.
  776.  
  777.   - wmax  "Maximize"  <Ctrl-Z>
  778.  
  779.     This command "maximizes" or resizes the current window to make it
  780.     fill the entire screen so that the borders are not visible. You can
  781.     also maximize a window with the mouse by clicking the left mouse
  782.     button on the "maximize" icon () in the upper right corner of the
  783.     window, or by double clicking on the north or south title bar.
  784.  
  785.   - wmin  "Minimize"
  786.  
  787.     This command "minimizes" or resizes the current window so that only
  788.     the title bar displaying the file or directory name is visible.
  789.     Using the mouse, you can minimize a window by clicking the left
  790.     mouse button on the "minimize" icon () in the upper right corner of
  791.     the window.
  792.                                                              Windows   5
  793.  
  794.  
  795.   - wres  "Restore"
  796.  
  797.     This command restores the size of a previously minimized or
  798.     maximized window. Using the mouse, you can restore the window by
  799.     clicking the left mouse button on the "restore" icon () in the
  800.     upper right corner of the window, or by double clicking on the north
  801.     or south title bar.
  802.  
  803.  
  804.   Several commands are available for arranging windows on the screen.
  805.   These commands operate on all non-minimized windows in the current
  806.   edit session.
  807.  
  808.   - wcasc  "Cascade"  <Shift-F5>
  809.  
  810.     This command will cascade all the windows on the screen.
  811.  
  812.   - wtileh  "Tile Horz"  <Shift-F4>
  813.  
  814.     This command will horizontally tile all the windows on the screen.
  815.     The "TileNum" configuration setting affects the way windows are
  816.     tiled (see "Configuration - Window Preferences" 17-9).
  817.  
  818.   - wtilev  "Tile Vert"  <Shift-F3>
  819.  
  820.     This command will vertically tile all the windows on the screen. The
  821.     "TileNum" configuration setting affects the way windows are tiled
  822.     (see "Configuration - Window Preferences" 17-9).
  823.  
  824.   There are three commands that allow you to edit the same file in more
  825.   than one window. These commands work only in Edit windows:
  826.  
  827.   - wcopy  "Copy"  <Ctrl-C>
  828.  
  829.     This command copies the current Edit window and cascades it with the
  830.     original. The new window will edit the same file in memory as the
  831.     original window, and have the same size and cursor position.
  832.  
  833.   - wspl %h  "Split Horz"  <Alt-H>
  834.  
  835.     This command splits the current Edit window horizontally. The new
  836.     window will edit the same file in memory as the original window.
  837.  
  838.   - wspl %v  "Split Vert"  <Alt-V>
  839.  
  840.     This command splits the current Edit window vertically. The new
  841.     window will edit the same file in memory as the original window.
  842.                                                              Panning   6
  843.  
  844.  
  845.   2-3  Panning the Screen
  846.   ───────────────────────
  847.  
  848.   The physical screen that you see when you use The Aurora Editor is
  849.   only a small window into the "virtual" screen actually used by the
  850.   editor, in the same way that an Edit window can be a small window into
  851.   a much larger file. To The Aurora Editor, the actual screen size is
  852.   64k x 64k characters!
  853.  
  854.   When the editor is initially loaded, the physical screen is located at
  855.   column 16000 and row 16000 of the virtual screen. You can adjust this
  856.   mapping of the physical screen to the virtual screen by using the
  857.   video "panning" commands:
  858.  
  859.   - to "pan" using the mouse:
  860.  
  861.     To pan the screen, position the mouse over the screen background and
  862.     press the left mouse button. Then just drag the entire screen to the
  863.     new location and release the left mouse button.
  864.  
  865.   - wkey %p  "Pan"  <Ctrl-F6>
  866.  
  867.     This command places the editor in "pan" mode, and allows you to pan
  868.     through the virtual screen using the cursor keys, When you have
  869.     panned to desired location, press <Enter> or <Esc> to stop.
  870.  
  871.  
  872.   2-4  Window Styles
  873.   ──────────────────
  874.  
  875.   You can easily configure the appearance of Edit windows and File
  876.   Manager windows to suit your own preferences (see the configuration
  877.   settings for "Window Preferences" 17-9). You can control whether or
  878.   not windows will have permanent Menu Bars, Tool Bars, Scroll Bars, and
  879.   Title Bars. You can also configure the location of the window Title,
  880.   Status Line, and Control Icons.
  881.  
  882.   The following command on the "Window" pulldown menu can be used to
  883.   change Edit window styles within an edit session:
  884.  
  885.   - winsty  "Style Toggle"  <Ctrl-F7>
  886.  
  887.     This command toggles through about 13 "common" Edit window styles.
  888.     When this command is entered, the styles of all open Edit windows
  889.     are changed immediately. You can use the "setsav" command to save
  890.     the current Edit window style ("Save Current Settings" on the "Set"
  891.     pull-down menu).
  892.  
  893.     Note: this command only changes the style of Edit windows, not File
  894.     Manager windows.
  895.                                                          Video Modes   7
  896.  
  897.  
  898.   2-5  Video Modes
  899.   ────────────────
  900.  
  901.   The video mode used by The Aurora Editor can be changed during an
  902.   editing session from the "Set" pulldown menu under the "Video Mode"
  903.   submenu. You can choose from the following video modes:
  904.  
  905.     - 80 cols x 14 rows  (vga only)
  906.     - 80 cols x 21 rows  (vga only)
  907.     - 80 cols x 25 rows
  908.     - 80 cols x 28 rows  (vga only)
  909.     - 80 cols x 43 rows  (ega & vga only)
  910.     - 80 cols x 50 rows  (vga only)
  911.  
  912.     - 40 cols x 25 rows
  913.  
  914.  
  915.   You can also use the following commands to change the video mode:
  916.  
  917.   - vfont %t  "Video Toggle"  <Ctrl-F1>
  918.  
  919.     This command toggles back and forth between the 80 x 25 video mode
  920.     and the 80 x 50 video mode.
  921.  
  922.   - vfont  [columns]  [rows]
  923.  
  924.     This command sets the number of columns and rows displayed on the
  925.     video screen. Acceptable values for [columns] are 40 and 80.
  926.     Acceptable values for rows are: 12, 14, 21, 25, 28, 43, and 50.
  927.  
  928.  
  929.   Using the "VidCols" and "VidRows" configuration settings, you can set
  930.   the default video mode to use when the editor is initially loaded (see
  931.   "Configuration - Video" 17-2).
  932.  
  933.   Note: The Aurora Editor will also work in other "special" video modes
  934.   supported by your video card (such as 132 x 43). To use these modes,
  935.   You must set "VidCols" and "VidRows" to zero, and then set the video
  936.   mode before starting the editor (see the documentation for your video
  937.   card). A special mouse driver may also be required to use the mouse
  938.   properly in some of these modes.
  939.  
  940.  
  941.   2-6  Prompts
  942.   ────────────
  943.  
  944.   A Prompt is a special type of window through which you can enter
  945.   information requested by The Aurora Editor. Individual prompts can be
  946.                                                              Prompts   8
  947.  
  948.  
  949.   tailored by the user to appear as dialog boxes, one-line boxes, or
  950.   command line prompts. By default, all prompts are tailored to appear
  951.   as one-line boxes at installation. More experienced users may prefer
  952.   to tailor some or all editor prompts as command lines for their small
  953.   size, and less experienced users may prefer dialog boxes (see the
  954.   "Prompts" configuration setting in "Configuration - Editing
  955.   Preferences" 17-8).
  956.  
  957.   The follow section describes the available prompt types:
  958.  
  959.  
  960.   Dialog boxes:
  961.  
  962.     If a prompt window is tailored to appear as a dialog box, the window
  963.     client area may contain edit fields, buttons, and check boxes. You
  964.     can use the mouse or the <Tab> and <Shift-Tab> keys to move back and
  965.     forth between the edit fields, buttons, and check boxes. Like Edit
  966.     windows and File Manager windows, dialog boxes can be moved anywhere
  967.     on the screen by using the mouse or keyboard.
  968.  
  969.   One-line boxes:
  970.  
  971.     If the prompt window is tailored to appear as a one-line box, it
  972.     will occupy 3 lines on the screen (2 border lines and 1 command
  973.     line), and will appear immediately above or below the current cursor
  974.     position. You can use the mouse or the keyboard to move the one-line
  975.     box anywhere on the screen. Pressing <Esc> or clicking the left
  976.     mouse button on the prompt description will close the one-line box.
  977.  
  978.   Command lines:
  979.  
  980.     If the prompt window is tailored to appear as a command line, it
  981.     will occupy only one line on the screen. It will be displayed
  982.     immediately below (or above) the title bar displaying the file or
  983.     directory name. The entire area within the window will be visible.
  984.     Pressing <Esc> or clicking the left mouse button on the prompt
  985.     description will close the command line prompt.
  986.  
  987.  
  988.   The following command on the Edit window "Window" pull-down menu can
  989.   be used to globally change the prompt type from within the editor:
  990.  
  991.   - wppt  "Prompt Toggle"
  992.  
  993.     This command toggles the prompt type (for all prompts) between
  994.     Dialog boxes, One-line boxes, and Command lines. The change is
  995.     effective immediately. Note that this command changes all prompts.
  996.     To tailor individual prompts, see the "Prompts" configuration
  997.     setting ("Configuration - Editing Preferences" 17-8).
  998.                                                              Prompts   9
  999.  
  1000.  
  1001.   Prompt history is available in some prompts. The following commands
  1002.   can be used to retrieve prompt history in any type of prompt:
  1003.  
  1004.   - wrtv %p  <cursorup>
  1005.  
  1006.     This command retrieves the previous item in the prompt history.
  1007.  
  1008.   - wrtv %n  <cursordown>
  1009.  
  1010.     This command retrieves the next item in the prompt history.
  1011.  
  1012.  
  1013.   You can also retrieve prompt history by clicking the left and right
  1014.   mouse buttons on the history tab () at the far right of the prompt.
  1015.  
  1016.   If the "SaveHis" configuration setting is ON, the prompt history for
  1017.   all prompts is saved in the file A.HIS when you exit the editor and
  1018.   restored when you re-enter (see "Configuration - Desktop Options"
  1019.   17-11).
  1020.  
  1021.   Prompt history is available in following prompts:
  1022.  
  1023.     - File prompts (Open, Open and Insert, Open Binary, Rename, Save As,
  1024.         Block Save, Load Key Macros, Save Key Macros, Run Macro, Include
  1025.         Macro, Compile Macro)
  1026.  
  1027.     - Search Prompts (Find, Replace, Scan, Place Bookmark, Go to
  1028.         Bookmark)
  1029.  
  1030.     - OS Command and Capture prompts
  1031.  
  1032.     - Macro Command prompt
  1033.                                                     Using the Menus   10
  1034.  
  1035.  
  1036.   3-1  Using the Menus
  1037.   ────────────────────
  1038.  
  1039.   Both Edit windows and File Manager windows have an easy-to-use menu
  1040.   bar with "pull-down" menus. The pull-down menus allow easy access to
  1041.   many of The Aurora Editor's commands, and also show the key
  1042.   definitions for most editor commands. They can be especially helpful when
  1043.   exploring or learning to use the editor.
  1044.  
  1045.   This diagram illustrates the menu bar and a pull-down menu:
  1046.  
  1047.   ┌────────────────────────────────────────────────────────────────────────┐
  1048.   │ File  Window  Block  Search  Fold  Edit  Clip  Print  Set  Macro  Help │
  1049.   └────────────────┬──┼───────────────────────────┬────────────────────────┤
  1050.                    │  │                           │ Print           Ctrl-P │
  1051.        Menu Bar ───┘  │      Pull Down Menu ──────┤ Print Block      Alt-P │
  1052.        Menu Bar Item ─┘      Menu Item ───────────┼─Print Formfeed         │
  1053.                                                   │ Print Settings..       │
  1054.                                                   └────────────────────────┘
  1055.  
  1056.  
  1057.   The following commands allow you to access the menu bar and pull-down
  1058.   menus:
  1059.  
  1060.   - using the mouse:
  1061.  
  1062.     Click the left mouse button on a menu bar item to display it's
  1063.     pull-down menu. If you have configured the menu bar to be invisible
  1064.     (see the "EditStyle" and "FmgrStyle" configuration variables 17-9),
  1065.     you can click the right mouse button in the window client area to
  1066.     make the menu bar visible and display the most recently used
  1067.     pull-down menu.
  1068.  
  1069.     Once the pull-down menu is displayed, click the left mouse button on
  1070.     the desired menu item to remove the pull-down menu and execute the
  1071.     editor command for that item.
  1072.  
  1073.   - menb  <Esc>, <F10>
  1074.  
  1075.     This command highlights the most recently selected menu bar item.
  1076.     You can then use the cursor left and right keys to change the
  1077.     highlighted item. Once you are on the menu bar, you can display any
  1078.     pull-down menu by typing in the menu bar item's highlighted
  1079.     character. When the desired menu bar item is highlighted, press
  1080.     <Enter> to display the pull-down menu. Pressing <Esc> will exit the
  1081.     menu bar.
  1082.  
  1083.                                                     Using the Menus   11
  1084.  
  1085.  
  1086.   - men  <Alt-F10>
  1087.  
  1088.     This command displays the most recently used pull-down menu. You can
  1089.     then use the cursor left and right keys to display the previous and
  1090.     next pull-down menu on the menu bar. Use the cursor up and down keys
  1091.     to move the highlight bar on the pull-down menu to the desired menu
  1092.     command and press <Enter> to execute it. You can also execute the
  1093.     menu command by typing in the highlighted character of the menu
  1094.     item, or by entering the function key (if any) associated with the
  1095.     menu item. Pressing <Esc> from the pull-down menu will return you to
  1096.     the menu bar.
  1097.  
  1098.     Four additional keys can be used within pull-down menus:
  1099.  
  1100.     - <Home> and <PgUp> move the cursor to the first menu item.
  1101.     - <End> and <PgDn> move the cursor to the last menu item.
  1102.  
  1103.   - men2  <Alt-T>, (and <Tab> on File Manager windows)
  1104.  
  1105.     This command highlights the first tool bar control on the Edit
  1106.     window tool bar (if present) or the first drive on the File Manager
  1107.     window drive menu bar. After this command is entered, you can use
  1108.     the <Tab>, <Shift-Tab>, <cursorleft>, and <cursorright> keys to move
  1109.     to other tool bar controls or drives. Pressing the <Enter> key will
  1110.     execute the tool bar control (or display the drive contents).
  1111.     Pressing <Esc> will remove the highlight and return the focus back
  1112.     to the Edit window or File Manager window.
  1113.  
  1114.   - menh  <F1>
  1115.  
  1116.     This command displays the help menu.
  1117.  
  1118.  
  1119.   If you wish, you can customize the whole menu system according to your
  1120.   own preferences by changing existing pull-downs, adding new pull-
  1121.   downs, etc (see "Defining the Menus" 18-5). You can also customize the
  1122.   tool bar to execute your most often-used commands (see "The Tool Bar"
  1123.   18-6).
  1124.  
  1125.   You can configure The Aurora Editor so that the menu bar is normally
  1126.   invisible and only displayed when the "menb" <Esc>,<F10> or "men"
  1127.   <Alt-F10> commands are entered, or when the right mouse button is
  1128.   pressed in the window client area. This will free up an extra line in
  1129.   the window for editing while still allowing you to use the menu system
  1130.   (see the "EditStyle" and "FmgrStyle" configuration settings 17-9).
  1131.  
  1132.   When you become more experienced with The Aurora Editor, you may
  1133.   prefer to use function keys to execute commands instead of selecting
  1134.   them from the menus. If you define your own functions keys, you will
  1135.   probably also want to change the menu pull-down definitions to show
  1136.   the new key assignments (see "Defining the Menus" 18-5).
  1137.                                                     The Status Line   12
  1138.  
  1139.  
  1140.   4-1  The Edit Window Status Line
  1141.   ────────────────────────────────
  1142.  
  1143.   By default, the Edit window status line is displayed in the north
  1144.   title bar at the upper right corner of the Edit window. Note that the
  1145.   location of the status line can be configured to be on the north or
  1146.   south title bar and can be right justified, left justified, or
  1147.   centered within the title bar (see the "EditStatus" configuration
  1148.   setting 17-9).
  1149.  
  1150.   The status line displays information about the file in an Edit window.
  1151.   The following is a sample status line:
  1152.  
  1153.   ┌───────────────────────────────────────┐
  1154.   │ SVTWAMBDIR* [20]  C 12  L 153  of 321 │
  1155.   └─┬┬┬┬┬┬┬┬┬┬┬──┬──────┬──────┬───────┬──┘
  1156.     │││││││││││  │      │      │       │
  1157.     │││││││││││  │      │      │       └─>  total lines in the file
  1158.     │││││││││││  │      │      └───────>  line number of the cursor
  1159.     │││││││││││  │      └────────────>  column number of the cursor
  1160.     │││││││││││  └─────────────────>  hex value of the char at the cursor
  1161.     ││││││││││└──────────────────>  '*' indicates file is modified
  1162.     │││││││││└─────────────────>  'R' indicates Record Mode is ON
  1163.     ││││││││└────────────────>  'I' indicates Insert Mode is ON
  1164.     │││││││└───────────────>  'D' indicates Line Draw is ON
  1165.     ││││││└──────────────>  'B' indicates Backup is ON
  1166.     │││││└─────────────>  'M' indicates Match Character is ON
  1167.     ││││└────────────>  'A' indicates AutoIndent is ON
  1168.     │││└───────────>  'W' indicates Word Wrap is ON
  1169.     ││└──────────>  'T' indicates Text Translation is ON
  1170.     │└─────────>  'V' indicates Variable Tabs is ON
  1171.     └────────>  'S' indicates Smart Tabs is ON
  1172.  
  1173.  
  1174.   (For more information on Record Mode, Insert Mode, DrawMode, Backup,
  1175.   Match Character, AutoIndent, WordWrap, Text Translation, Variable
  1176.   Tabs, and Smart Tabs, see "Window Settings" 13-1).
  1177.                                          Creating and Loading Files   13
  1178.  
  1179.  
  1180.   5-1  Creating and Loading Files
  1181.   ───────────────────────────────
  1182.  
  1183.   The Aurora Editor can simultaneously edit almost any number of files,
  1184.   each of virtually any size (the virtual memory size of The Aurora
  1185.   Editor is 1 gigabyte). Each file can be displayed and edited in one or
  1186.   more windows.
  1187.  
  1188.   There are several commands to edit new or existing files:
  1189.  
  1190.   - from the command line:
  1191.  
  1192.     After entering "A" or "A3" on the DOS command line, enter any number
  1193.     of new or existing files. For example:
  1194.  
  1195.       C>a  myfile.c new.doc *.h  <Enter>
  1196.  
  1197.     For each file specified, an Edit window will be created. If the file
  1198.     exists, it will be loaded into the Edit window. If the specified
  1199.     name contains wildcards (* or ?), or specifies a drive or directory,
  1200.     then a File Manager window will be created which lists all files and
  1201.     directories that match the file specification.
  1202.  
  1203.   - from a File Manager window:
  1204.  
  1205.     You can select files to edit from the directory listing in a File
  1206.     Manager window. The File Manager also has other commands which allow
  1207.     you manipulate files on disk (see "The File Manager" 16-1).
  1208.  
  1209.   - newf  "New"  <Ctrl-N>
  1210.  
  1211.     This command creates a new Edit window with the filename "NEW.TXT".
  1212.     The new Edit window will contain one blank line.
  1213.  
  1214.   - askopen  "Open.."  <Alt-E>
  1215.  
  1216.     This command prompts you for a filename to open. You may enter a new
  1217.     or existing filename to create an Edit window for the filename, or
  1218.     you may enter a directory name or a wildcard specification to create
  1219.     a File Manager Window. If you press <Enter> at the prompt without
  1220.     entering anything, a File Manager window will be created for the
  1221.     current directory.
  1222.  
  1223.     You can specify "open options" after the filename or directory name
  1224.     by entering a "/" character and any of the following options:
  1225.                                          Creating and Loading Files   14
  1226.  
  1227.  
  1228.       i - include the file or directory listing after the cursor in the
  1229.           current window
  1230.  
  1231.       b - load the file in "binary" mode (see the "askopenb" command
  1232.           below). The binary line length can be specified after this
  1233.           option (if not specified, then the "BinaryLength"
  1234.           configuration setting is used). This option is ignored when
  1235.           entering a directory or wildcard specification.
  1236.  
  1237.       z - maximize the new window
  1238.  
  1239.       n - minimize the new window
  1240.  
  1241.       c - new windows are the same size as the topmost window and are
  1242.           cascaded to bottom and left of the topmost window.
  1243.  
  1244.       e - load the file into the current edit window without discarding
  1245.           the existing file in the edit window. This option is added
  1246.           automatically if the "OneWindow" configuration setting is ON
  1247.           (see "Configuration - Editing Preferences" 17-8).
  1248.  
  1249.       l - enter a line number after the "l" option to position the
  1250.           cursor at the specified line number
  1251.  
  1252.     Note: open options can also be specified when loading files from
  1253.     the DOS command line.
  1254.  
  1255.     For example, entering "c:\doc\test.dat/zb32" at the "askopen" prompt
  1256.     will the open the file "c:\doc\test.dat" in binary mode (with a line
  1257.     length of 32) and display it in a maximized window.
  1258.  
  1259.     Entering "c:\doc\test.dat/l689" opens "c:\doc\test.dat" and places
  1260.     the cursor on line number 689.
  1261.  
  1262.     Note that prompt history is available at this prompt (see "Prompts"
  1263.     2-6).
  1264.  
  1265.   - askopenb  "Open Binary.."
  1266.  
  1267.     This command works like askopen, except that if a file is specified,
  1268.     it is opened in "binary" mode. When a file is opened in binary mode,
  1269.     no characters in the file are interpreted as end-of-line delimiters.
  1270.     The entire file is loaded "as is" into an Edit window. The length of
  1271.     each line is the same (except for the last line), and is determined
  1272.     by the "BinaryLength" configuration setting (see "Configuration -
  1273.     Open Options" 17-6).
  1274.  
  1275.     "Open options" can be specified in this prompt (see "askopen"
  1276.     above).
  1277.  
  1278.     Prompt history is available at this prompt (see "Prompts" 2-6).
  1279.                                          Creating and Loading Files   15
  1280.  
  1281.  
  1282.   - openlast  "Open Last"  <Alt-Z>
  1283.  
  1284.     This command re-opens the last Edit window or File Manager window
  1285.     that you closed.
  1286.  
  1287.   - open  [filename or directory]  [open options]
  1288.  
  1289.     This command opens the filename or directory with the
  1290.     specified open options (see the "askopen" command above for a description
  1291.     of open options). No Prompts are displayed. For example:
  1292.  
  1293.       open "c:\config.sys" %bc.
  1294.  
  1295.     The command above loads the file "c:\config.sys" in binary mode in a
  1296.     cascaded window.
  1297.  
  1298.   - opena  [filename]
  1299.  
  1300.     This command opens the specified configuration file for The Aurora
  1301.     Editor (ACFG.A, AKBD.A, AMEN.A, ATRN.A) without prompting. There is
  1302.     no need to specify a path or extension. For example:
  1303.  
  1304.       opena "akbd".
  1305.  
  1306.     The command above loads The Aurora Editor keyboard definition file.
  1307.  
  1308.  
  1309.   You can press the <Ctrl-Break> key to interrupt any of the above open
  1310.   commands in progress.
  1311.  
  1312.   Note that any files not loaded in binary mode will use the value of
  1313.   the "LineDlm" configuration setting as the line delimiter string. The
  1314.   default LineDlm setting is "0D0Ah" (carriage return and linefeed).
  1315.  
  1316.   If the "SaveWin" configuration setting is ON and the file you are
  1317.   opening was previously closed, The Aurora Editor will automatically
  1318.   restore the window size, position, settings, and cursor position
  1319.   exactly as they were before you closed the window (see "Configuration
  1320.   - Desktop Options" 17-11).
  1321.  
  1322.  
  1323.   5-2  Saving and Discarding Files
  1324.   ────────────────────────────────
  1325.  
  1326.   Several commands are available for discarding files and saving files
  1327.   to disk:
  1328.  
  1329.   - save  "Save"  <F3>
  1330.  
  1331.     This command saves the file in the current Edit window to disk. If
  1332.     the file was loaded or created as a "binary" file, it will be saved
  1333.     "as is" with no line delimiter characters, otherwise each line will
  1334.     be appended with the value of the "LineDlm" configuration setting
  1335.     (see "Configuration - Open Options" 17-6).
  1336.                                         Saving and Discarding Files   16
  1337.  
  1338.  
  1339.     If the "Backup" setting is ON, any existing files with the same name
  1340.     on disk will be backed-up (see "Window Settings" 13-1).
  1341.  
  1342.   - asksaveas  "Save As.."
  1343.  
  1344.     This command prompts you for a filename, and then saves the file in
  1345.     the current Edit window under that filename (just like the "save"
  1346.     command above).
  1347.  
  1348.     Prompt history is available at this prompt (see "Prompts" 2-6).
  1349.  
  1350.   - save  [filename]
  1351.  
  1352.     This command saves the file in the current Edit window under the
  1353.     specified filename, without prompting.
  1354.  
  1355.   - quit %p
  1356.  
  1357.     This command closes the current window and removes it from the
  1358.     screen. The file displayed in the window is also closed. If changes
  1359.     were made without saving, you will be prompted to save them.
  1360.  
  1361.     If the "SaveWin" configuration setting is ON, The Aurora Editor will
  1362.     save the window size, position, settings, and cursor position. When
  1363.     the file is edited again, the editor will automatically restore the
  1364.     window size, position, settings, and cursor position exactly as they
  1365.     were before you closed the window.
  1366.  
  1367.   - gquit %p  "Close All"  <Alt-X>
  1368.  
  1369.     This command closes all windows and files in the current edit
  1370.     session and exits the editor. If changes were made to any file
  1371.     without saving, you will be prompted to save them.
  1372.  
  1373.     If the "SaveHis" configuration setting is ON and the "BootOpt"
  1374.     configuration setting is "d" (desktop), The Aurora Editor will save
  1375.     the window size, position, settings, and cursor position for the
  1376.     windows in current edit session (i.e. the "desktop"). If you then
  1377.     re-enter the editor without specifying a filename after the "A" or
  1378.     "A3" command at the DOS prompt, the desktop will automatically be
  1379.     restored, with all windows present as they were when you left the
  1380.     editor.
  1381.  
  1382.   - quit %f
  1383.  
  1384.     This command saves the file in the current Edit window (like the
  1385.     "save" command above), and then closes the file and the window.
  1386.  
  1387.   - gquit %f  "Save and Close All"
  1388.  
  1389.     This command saves the files in all open Edit windows and exits the
  1390.     editor.
  1391.                                         Saving and Discarding Files   17
  1392.  
  1393.  
  1394.   The effects of the following commands depend on the value of the
  1395.   "OneWindow" configuration setting (see "Configuration - Editing
  1396.   Preferences 17-8).
  1397.  
  1398.   - wquit %p  <Ctrl-K-Q>
  1399.  
  1400.     If the configuration setting "OneWindow" is OFF, this command closes
  1401.     both the current window and the file displayed in the window
  1402.     (identical to the "quit %p" command above).
  1403.  
  1404.     If "OneWindow" is ON, this command closes the current window without
  1405.     closing the file displayed in the window.
  1406.  
  1407.   - fquit %p  "Close"  <Alt-Q>
  1408.  
  1409.     If the configuration setting "OneWindow" is OFF, this command closes
  1410.     both the current window and the file displayed in the window
  1411.     (identical to the "quit %p" command above).
  1412.  
  1413.     If "OneWindow" is ON, this command closes the file in an Edit window
  1414.     without closing the Edit window. The previous open file is displayed
  1415.     in the Edit window.
  1416.  
  1417.   - fquit %f  "Save and Close"  <Ctrl-X>
  1418.  
  1419.     If the configuration setting "OneWindow" is OFF, this command saves
  1420.     the file in the current Edit window, and then closes the file and
  1421.     the window (identical to the "quit %f" command above).
  1422.  
  1423.     If "OneWindow" is ON, this command saves and closes the file in an
  1424.     Edit window without closing the Edit window. The previous open file
  1425.     is displayed in the Edit window.
  1426.  
  1427.  
  1428.   The following commands allow you edit more than one file per window:
  1429.  
  1430.   - fnex "Next"  <Ctrl-Del>
  1431.  
  1432.     This command cycles through all open files in a forward direction
  1433.     and displays them in the current Edit window.
  1434.  
  1435.   - fpre "Prev"  <Ctrl-Ins>
  1436.  
  1437.     This command cycles through all open files in a reverse direction
  1438.     and displays them in the current Edit window.
  1439.  
  1440.   - flis "List.."  <Alt-Hyphen>
  1441.  
  1442.     This command displays a menu which lists all the open files in your
  1443.     current edit session. To select a file for editing, use the cursor
  1444.     keys to position the highlighted bar over the window name and press
  1445.     <Enter>. You can also select a file from the list using the left
  1446.     mouse button.
  1447.                                                 Other File Commands   18
  1448.  
  1449.  
  1450.     If you select a file from the list, the selected file replaces the
  1451.     existing file in the Edit window (without closing the existing
  1452.     file).
  1453.  
  1454.  
  1455.   5-3  Other File Commands
  1456.   ────────────────────────
  1457.  
  1458.   Other useful "File" commands are also available:
  1459.  
  1460.  
  1461.   - askopenins  "Open and Insert.."  <Alt-I>
  1462.  
  1463.     This command prompts you for a filename, and then inserts the file
  1464.     after the cursor in the current Edit window. You can also enter a
  1465.     directory name, a name with wildcards (*, ?), or just <Enter> to
  1466.     select a filename from a File Manager window.
  1467.  
  1468.     "Open options" can be specified in this prompt (see the "askopen"
  1469.     command 5-1).
  1470.  
  1471.     Prompt history is available at this prompt (see "Prompts" 2-6).
  1472.  
  1473.   - wrdlod CSetB  <Ctrl-]>
  1474.  
  1475.     This command opens the filename at the cursor. "CSetB" is the
  1476.     character set used to define a filename for this command (see
  1477.     "Configuration - Character Sets" 17-14).
  1478.  
  1479.   - refresh
  1480.  
  1481.     This command refreshes the contents of the current window from disk.
  1482.  
  1483.   - askname  "Rename"  <Alt-N>
  1484.  
  1485.     This command prompts you for a filename, and then changes the name
  1486.     of the current Edit window to the filename you entered. Note that
  1487.     this command only renames the Edit window, not the file on disk (the
  1488.     File Manager can rename a file or directory on disk, see "The File
  1489.     Manager" 16-1).
  1490.  
  1491.     Prompt history is available at this prompt (see "Prompts" 2-6).
  1492.  
  1493.   - name  [filename]
  1494.  
  1495.     This command changes the name of the current Edit window to the
  1496.     specified filename, without prompting you for the filename.
  1497.  
  1498.   - fmgr  "File Manager.."  <F4>
  1499.  
  1500.     This command displays a File Manager window for the current
  1501.     directory.
  1502.                                                 Other File Commands   19
  1503.  
  1504.  
  1505.   - about  "About.."
  1506.  
  1507.     This command displays a dialog box showing the current version
  1508.     number of The Aurora Editor, and the current date and time.
  1509.  
  1510.   - hlp  [major]  [minor]
  1511.  
  1512.     This command displays The Aurora Editor User's Guide (this
  1513.     document), and positions the cursor at the section "[major] -
  1514.     [minor]". For example, "hlp 5 3" displays help on this section
  1515.     (see "Other File Commands").
  1516.  
  1517.   - qref  <Shift-F1>
  1518.  
  1519.     This command displays The Aurora Editor Quick Reference (AREF.DOC)
  1520.                                             Finding Your Way Around   20
  1521.  
  1522.  
  1523.   6-1  Finding Your Way Around
  1524.   ────────────────────────────
  1525.  
  1526.   Simple commands allow you to move the cursor in both Edit windows and
  1527.   File Manager windows:
  1528.  
  1529.   - left   <cursorleft>
  1530.   - right  <cursorright>
  1531.   - up     <cursorup>
  1532.   - down   <cursordown>
  1533.  
  1534.     Use the cursor commands (left, right, up, down) to move the cursor
  1535.     one line or one column at a time. If you attempt to move the cursor
  1536.     outside the window, the window will automatically scroll to display
  1537.     the new line or column.
  1538.  
  1539.     You can also move the cursor by clicking the left mouse button at
  1540.     new cursor location.
  1541.  
  1542.   - cptop  <Ctrl-Home>
  1543.  
  1544.     This command moves the cursor to the line at the top of the window
  1545.     without scrolling or changing the cursor column.
  1546.  
  1547.   - cpbot  <Ctrl-End>
  1548.  
  1549.     This command moves the cursor to the line at the bottom of the window
  1550.     without scrolling or changing the cursor column.
  1551.  
  1552.   - cmov @ 1  <Ctrl-PgUp>
  1553.  
  1554.     This command moves the cursor to line 1 of the file or directory
  1555.     listing without changing the column (scrolling if necessary).
  1556.  
  1557.   - cmov @ (qtexend)  <Ctrl-PgDn>
  1558.  
  1559.     This command moves the cursor to the last line of the file or
  1560.     directory listing without changing the column (scrolling if
  1561.     necessary).
  1562.                                             Finding Your Way Around   21
  1563.  
  1564.  
  1565.   - cmov  [x]  [y]  [options]
  1566.  
  1567.     This command moves the cursor to the location specified by [x], [y]
  1568.     in the current window. The following [options] many be specified:
  1569.  
  1570.       a - [x] and [y] specify absolute column and line positions
  1571.       r - [x] and [y] are relative to the current cursor position
  1572.  
  1573.     If no [options] are specified, the default is "a".
  1574.  
  1575.   - clast  <Ctrl-Hyphen>
  1576.  
  1577.     This command moves the cursor to the previous cursor position,
  1578.     scrolling if necessary. This command can be useful for moving back
  1579.     and forth over large distances in an Edit window or File Manager
  1580.     window.
  1581.  
  1582.   - ladj @ -1  <Keypad-5>
  1583.  
  1584.     This command scrolls the text up or down so that the cursor is
  1585.     placed at the center of the window, without moving the cursor from
  1586.     the current line.
  1587.  
  1588.   - ladj @  1              <Ctrl-F9>
  1589.   - ladj @ (qwinp @ %y1d)  <Ctrl-F10>
  1590.  
  1591.     These commands scroll the text so that the cursor is placed at the
  1592.     top or bottom line of the window, without moving the cursor from the
  1593.     current line.
  1594.  
  1595.  
  1596.  
  1597.   The following commands move the cursor only in Edit windows:
  1598.  
  1599.   - chome  <Home>
  1600.  
  1601.     This command moves the cursor to column one of the current line.
  1602.  
  1603.   - ceol  <End>
  1604.  
  1605.     This command moves the cursor one column after the last non-blank
  1606.     character of the current line.
  1607.  
  1608.   - cwrd %l CSet  <Ctrl-Left>
  1609.   - cwrd %r CSet  <Ctrl-Right>
  1610.  
  1611.     These commands move the cursor to the first character of the
  1612.     previous or next word. The configuration setting "CSet" is the
  1613.     character set used to define a word for these commands (see
  1614.     "Configuration - Character Sets" 17-14).
  1615.                                             Finding Your Way Around   22
  1616.  
  1617.  
  1618.   - askbset  "Place Bookmark.."
  1619.  
  1620.     This command allows you to place a location marker or "bookmark" at
  1621.     the cursor position in the current Edit window. You can return to
  1622.     the bookmark later using the "askbget" or "bget" commands (see
  1623.     below). Bookmarks are automatically destroyed when the Edit window
  1624.     (and all of it's copies) containing the bookmark are closed.
  1625.  
  1626.     This command will prompt you to enter the name of the bookmark. Note
  1627.     that bookmark names are global to all windows. The current cursor
  1628.     position, window size and placement, and cursor insert mode are
  1629.     saved with the bookmark. They are restored when you return to the
  1630.     bookmark using the "askbget" or "bget" commands.
  1631.  
  1632.     Prompt history is available at this prompt (see "Prompts" 2-6).
  1633.  
  1634.   - bset  "Quick Bookmark"  <Ctrl-2>
  1635.  
  1636.     This command places a bookmark in the same way as the "askbset"
  1637.     command above, except that you will not prompted to enter a bookmark
  1638.     name. A bookmark name with the prefix "BOOK" is automatically
  1639.     generated by the editor.
  1640.  
  1641.   - bset  [bookmark name]
  1642.  
  1643.     This command will place a bookmark at the cursor position using the
  1644.     specified bookmark name, without prompting.
  1645.  
  1646.   - askbget  "Go to Bookmark.."
  1647.  
  1648.     This command prompts you to enter the name of a "bookmark" you have
  1649.     previously placed using the "askbset" or "bset" commands. The cursor
  1650.     will be moved to the "bookmark" cursor position, and the Edit window
  1651.     will be sized and placed as it was when the "askbset" or "bset"
  1652.     command was entered. If the bookmark is located in another Edit
  1653.     window, that window will become the current window before returning
  1654.     to the bookmark.
  1655.  
  1656.     Prompt history is available at this prompt (see "Prompts" 2-6).
  1657.  
  1658.   - bget  "Prev Bookmark"  <Ctrl-6>
  1659.  
  1660.     This command goes to the previous bookmark without prompting.
  1661.     Entering this command repeatedly will cycle through all existing
  1662.     bookmarks in all windows.
  1663.  
  1664.   - bget  [bookmark name]
  1665.  
  1666.     This command will go to the specified bookmark, without prompting.
  1667.                                             Finding Your Way Around   23
  1668.  
  1669.  
  1670.   - askglin  "Go to Line.."  <Ctrl-J>
  1671.  
  1672.     This command will prompt you for a line number, and then move the
  1673.     cursor directly to the line you specified, scrolling if necessary.
  1674.     The column position of the cursor is not changed.
  1675.  
  1676.   - glin  [line number]
  1677.  
  1678.     This command will move the cursor to the specified line number,
  1679.     without prompting.
  1680.  
  1681.   - askgcol  "Go to Column.."
  1682.  
  1683.     This command will prompt you for a column number, and then move the
  1684.     cursor directly to the column you specified, scrolling if necessary.
  1685.     The cursor line is not changed.
  1686.  
  1687.   - gcol  [column number]
  1688.  
  1689.     This command will move the cursor to the specified column number,
  1690.     without prompting.
  1691.  
  1692.   - mloc @ %t  "Go to Block Start"  <Ctrl-B>
  1693.   - mloc @ %b  "Go to Block End"
  1694.  
  1695.     These commands move the cursor to the top or bottom of the current
  1696.     marked block. If the marked block is in another Edit window, that
  1697.     window will be made the "current" window before executing these
  1698.     commands.
  1699.  
  1700.   - cfld     "Go to Next Fold"  <Alt-7>
  1701.   - cfld %r  "Go to Prev Fold"
  1702.  
  1703.     These commands move the cursor to the next or previous "top-level"
  1704.     text fold in the current Edit window (see "Folding Text" 10-1).
  1705.  
  1706.   - ctab     <Tab>
  1707.   - ctab %l  <Shift-Tab>
  1708.  
  1709.     These commands move the cursor to the next or previous tab stop. The
  1710.     tab stop can be one of 3 types, depending on which Window Settings
  1711.     are currently set ON, and the current cursor position (see "Window
  1712.     Settings" 13-1):
  1713.                                             Finding Your Way Around   24
  1714.  
  1715.  
  1716.     - Interval Tabs
  1717.  
  1718.       Interval Tabs are the default when the "Variable Tabs" and "Smart
  1719.       Tabs" settings are turned OFF. The location of the tab stops are
  1720.       defined by the "TabWidth" configuration setting. For example,
  1721.       setting TabWidth to 8 will set tab stops at every 8th column
  1722.       position (1, 9, 17, 25, etc).
  1723.  
  1724.     - Variable Tabs
  1725.  
  1726.       Variable Tabs are used when the "Variable Tabs" setting is ON and
  1727.       the "Smart Tabs" setting is OFF. If Variable Tabs are set ON, the
  1728.       cursor will move to the next preset tab position you have
  1729.       specified in the "Tabs" configuration setting (see "Configuration
  1730.       - Word Processing" 17-4).
  1731.  
  1732.     - Smart Tabs
  1733.  
  1734.       If the "SmartTabs" configuration setting is set ON, the cursor is
  1735.       moved to the beginning of the next or previous word on the first
  1736.       non-blank line before the current line. This can be useful for
  1737.       aligning data with columns on the previous line.
  1738.  
  1739.  
  1740.   - finm  "Find Matching Char"  <Alt-F3>
  1741.  
  1742.     This command moves the cursor to the matching parenthesis (), brace
  1743.     {}, square bracket [], or angled bracket <> for the character at the
  1744.     cursor. If the character at the cursor is not one of these
  1745.     characters, then the cursor is moved to the next parenthesis, brace,
  1746.     or bracket, if one exists.
  1747.  
  1748.     This command can be very useful for balancing expressions in
  1749.     programming languages.
  1750.  
  1751.   - finc  "Go to Compiler Error"  <Alt-F7>
  1752.  
  1753.     This command can be used together with the "askoscap" <Alt-F8>
  1754.     command ("OS Capture.." on the "Macro" pulldown menu) to aid in
  1755.     running external compilers and locating compiler errors from within
  1756.     The Aurora Editor.
  1757.  
  1758.     Use the "askoscap" <Alt-F8> command ("OS Capture" on the "Macro"
  1759.     pull-down menu) to enter the command you use to compile or build
  1760.     your program. The "askoscap" command will run your compiler and
  1761.     return the compiler output in an Edit window.
  1762.                                             Finding Your Way Around   25
  1763.  
  1764.  
  1765.     You can then use the "finc" <Alt-F7> command to locate compiler
  1766.     errors. Just move cursor to the line containing the error
  1767.     description in the compiler output, and enter the "finc" <Alt-F7>
  1768.     command. The editor will automatically open the source file
  1769.     containing the error, and place the cursor on the line where the
  1770.     compiler error occurred.
  1771.  
  1772.     Note: the only Microsoft C, Borland C, and Turbo Pascal compilers
  1773.     are currently supported.
  1774.  
  1775.  
  1776.   6-2  Scrolling
  1777.   ──────────────
  1778.  
  1779.   The following commands can be used to scroll through both Edit windows
  1780.   and File Manager windows:
  1781.  
  1782.   - using the mouse:
  1783.  
  1784.     Use the vertical scroll bar for scrolling up or down, and the
  1785.     horizontal scroll bar for scrolling left or right. To scroll by one
  1786.     page, click the left mouse button on the portion of the scroll bar
  1787.     between the scroll bar thumb and the scroll bar arrows. To scroll by
  1788.     one line or column, click the left mouse button on the scroll bar
  1789.     arrows.
  1790.  
  1791.     Scrolling will repeat until you release the left mouse button (see
  1792.     the "MouHold" and "MouDelay" configuration settings 17-3). You can
  1793.     also scroll by pressing the left mouse button on the scroll bar
  1794.     thumb, dragging it to the desired position, and then releasing the
  1795.     left mouse button.
  1796.  
  1797.   - scry (- (ypagsiz))  <PgUp>
  1798.   - scry (ypagsiz)      <PgDn>
  1799.  
  1800.     These commands scroll the current window up or down by one page
  1801.     minus one line.
  1802.  
  1803.   - scry (- (/ (ypagsiz) 2))
  1804.   - scry (/ (ypagsiz) 2)
  1805.  
  1806.     These commands scroll the current window up or down by one-half
  1807.     page.
  1808.  
  1809.   - scry -1  <Ctrl-Up>
  1810.   - scry  1  <Ctrl-Down>
  1811.  
  1812.     These commands scroll the current window up or down by one line.
  1813.                                                           Scrolling   26
  1814.  
  1815.   - scrx (- (xpagsiz))  <F7>
  1816.   - scrx (xpagsiz))     <F8>
  1817.  
  1818.     These commands scroll the current window left or right by one page
  1819.     minus one column.
  1820.  
  1821.  
  1822.   6-3  Modifying Text
  1823.   ───────────────────
  1824.  
  1825.   The Aurora Editor provides many easy-to-use commands for modifying the
  1826.   text in an Edit window:
  1827.  
  1828.   - cmtog  <Ins>
  1829.  
  1830.     This command toggles the "insert mode" for the current Edit window.
  1831.     The insert mode is local to each Edit window. If the insert mode is
  1832.     ON, any characters entered will be inserted into the current line at
  1833.     the cursor. If insert mode is OFF, any characters entered will
  1834.     replace existing characters at cursor.
  1835.  
  1836.     Note that the insert mode can affect the operation of other
  1837.     commands, depending on the current configuration settings. See the
  1838.     section "Configuration - Editing Preferences" (17-8) and the
  1839.     configuration settings "EnterIns", "EnterOvl", "TabShift", and
  1840.     "BakOvl".
  1841.  
  1842.   - delch  <Del>
  1843.  
  1844.     This command will delete the character at the cursor. The characters
  1845.     to the right of the cursor will be shifted left by one column.
  1846.  
  1847.     If the configuration setting "DelJoin" is ON and the cursor is
  1848.     beyond the end of the line, the next line will be joined to the
  1849.     current line at the cursor.
  1850.  
  1851.   - baksp  <Backspace>
  1852.  
  1853.     This command moves the cursor left one column and deletes the
  1854.     character at the new cursor position. The characters to the right of
  1855.     the cursor are shifted left by one column.
  1856.  
  1857.     If the configuration setting "BakOvl" is set ON and the insert mode
  1858.     for the current window is OFF, the characters to the right of the
  1859.     cursor position will not be shifted.
  1860.  
  1861.     If the configuration setting "BakJoin" is set ON and the cursor is
  1862.     at column 1, then the current line will be joined to the end the
  1863.     previous line when executing this command.
  1864.                                                      Modifying Text   27
  1865.  
  1866.  
  1867.   - leol %l  <Alt-F6>
  1868.   - leol     "Erase to End"  <F6>
  1869.  
  1870.     These commands delete the characters from the current cursor
  1871.     position to the beginning or to the end of the line.
  1872.  
  1873.   - wrddel CSet  "Delete Right Word"  <Ctrl-T>
  1874.  
  1875.     This command deletes all characters from the cursor to the end of
  1876.     the word at the cursor. The configuration setting "CSet" is the
  1877.     character set used to define a word for this command (see
  1878.     "Configuration - Character Sets" 17-14).
  1879.  
  1880.     If the configuration setting "DelJoin" is ON and the cursor is at
  1881.     the end of the line, the next line will be joined to the current
  1882.     line at the cursor.
  1883.  
  1884.   - wrdcas  [options]  [char set].
  1885.  
  1886.     This command changes the case of the word at the cursor. The
  1887.     following [options] may be specified:
  1888.  
  1889.       l - change the word to lower case
  1890.       u - change the word to upper case
  1891.  
  1892.     Specifying both options "l" and "u" will toggle the case of each
  1893.     character in the word. If no [options] are specified, the default is
  1894.     "u".
  1895.  
  1896.     [char set] specifies the character set used to define a word for
  1897.     this command (see "Configuration - Character Sets" 17-14). If not
  1898.     specified, the default is "CSet".
  1899.  
  1900.   - lins %a  "Insert Line"  <Ctrl-Enter>
  1901.  
  1902.     This command inserts a new line after the line at the cursor.
  1903.  
  1904.     If "AutoIndent" is ON, the cursor is moved to the first non-blank
  1905.     column of the previous line. If the previous line is blank, then the
  1906.     cursor is moved to the first non-blank column of the next line. If
  1907.     the next line is also blank, the cursor column does not change.
  1908.  
  1909.     If the "AutoIndent" is OFF, the cursor is moved to column one.
  1910.  
  1911.   - lins %c
  1912.  
  1913.     This command is similar to the "lins %a" command above, except that
  1914.     the cursor column position is not changed.
  1915.                                                      Modifying Text   28
  1916.  
  1917.  
  1918.   - ldel  "Delete Line"  <Ctrl-Backspace>
  1919.  
  1920.     This command deletes the line at the cursor. The text below the
  1921.     cursor is shifted up by one line.
  1922.  
  1923.     Note: entering the "mdel" <Alt-D> command will also delete the line
  1924.     at the cursor if no marked block currently exists and the "DelLine"
  1925.     configuration setting is ON (see "Using Marked Blocks" 8-1).
  1926.  
  1927.   - lspl  "Split Line"  <Alt-S>
  1928.  
  1929.     This command splits the line at the cursor. The text from the cursor
  1930.     to the end of the line will be moved to a new line inserted after
  1931.     the cursor. If "AutoIndent" is ON, the beginning of the new line
  1932.     will be aligned with the beginning of the original line, otherwise
  1933.     the new line is moved to column one.
  1934.  
  1935.   - ljoin  "Join Line"  <Alt-J>
  1936.  
  1937.     This command appends the line below the cursor to the line at the
  1938.     cursor. If the cursor is positioned on or before the end of the
  1939.     line, the line below the cursor is joined to the end of the current
  1940.     line. If the cursor is positioned after the end of the line, the
  1941.     line below the cursor is joined at the cursor position.
  1942.  
  1943.   - ldup  "Duplicate Line"  <Alt-4>
  1944.  
  1945.     This command duplicates the line at the cursor.
  1946.  
  1947.     Note: entering the "mcpy" <Alt-C> command will also duplicate the
  1948.     line at the cursor if no marked block currently exists and the
  1949.     "CopyLine" configuration setting is ON (see "Using Marked Blocks"
  1950.     8-1).
  1951.  
  1952.   - lswp  "Swap Lines"  <Alt-5>
  1953.  
  1954.     This command swaps the line at the cursor with the following line.
  1955.  
  1956.   - lcen  "Center Line"  <Alt-6>
  1957.  
  1958.     This command centers the line at the cursor between the Left and
  1959.     Right margins.
  1960.  
  1961.   - lcom  "Comment Line"  <Alt-F1>
  1962.  
  1963.     This command "comments out" the line at the cursor by prefixing it
  1964.     with the string "//". If the line is already commented-out, then it
  1965.     is "un-commented" by removing the string "//". The cursor is moved
  1966.     to the next line without changing the column position.
  1967.                                                      Modifying Text   29
  1968.  
  1969.  
  1970.   - lcom  [string1]  [string2].
  1971.  
  1972.     This command "comments out" the line at the cursor by enclosing it
  1973.     between the strings [string1] and [string2]. If the line is already
  1974.     commented-out, then it is "un-commented" by removing the enclosing
  1975.     strings [string1] and [string2]. The cursor is moved to the next
  1976.     line without changing the column position.
  1977.  
  1978.   - enteredit  <Enter>
  1979.  
  1980.     The action taken when this command is entered depends on the insert
  1981.     mode for the current Edit window and the configuration settings
  1982.     "EnterOvl" and "EnterIns".
  1983.  
  1984.     "EnterOvl" defines the action to take when this command is entered
  1985.     and the cursor is in overlay mode. "EnterIns" defines the action to
  1986.     take when this command is entered and the cursor is in insert mode.
  1987.     You can choose one of the following values for both EnterOvl and
  1988.     EnterIns:
  1989.  
  1990.       i - inserts a new line
  1991.       s - splits the line at the cursor and moves the cursor to the
  1992.           beginning of the next line
  1993.       null - moves the cursor to the beginning of the next line
  1994.  
  1995.   - lit  "Enter Literal.."  <Ctrl-[>
  1996.  
  1997.     This command prompts you to enter a character "literally" into an
  1998.     Edit window. Any key entered is interpreted as a "type-able" key,
  1999.     not a function key.
  2000.  
  2001.     You can use this command to enter any ascii character into a file.
  2002.     At the literal prompt, hold down the <Alt> key, enter the ascii
  2003.     value of the character with the keypad keys, and then release the
  2004.     <Alt> key. Binary zeros can be entered by pressing <Shift-F1> at the
  2005.     literal prompt.
  2006.  
  2007.   - wasc  "Ascii Chart.."  <Alt-=>
  2008.  
  2009.     This command displays a menu which lists all 256 ascii characters
  2010.     and their decimal and hex values. You can select an ascii character
  2011.     from the menu and enter it into the current Edit window by pressing
  2012.     the <Enter> key over the character or by selecting it with the left
  2013.     mouse button. Pressing <Esc> cancels the ascii chart.
  2014.  
  2015.     Note: The ascii chart can also be used within an editor prompt.
  2016.                                                      Modifying Text   30
  2017.  
  2018.  
  2019.   - txt  [string]
  2020.  
  2021.     This command enters the string [string] at the cursor as if it had
  2022.     been typed in. If the cursor is in insert mode, the string is
  2023.     inserted into the text at the cursor, otherwise the string will
  2024.     overlay the text at the cursor.
  2025.  
  2026.   - stamp  "Date/Time Stamp"  <Ctrl-K-T>
  2027.  
  2028.     This command enters the current date and time at the cursor as if it
  2029.     had been typed in. If the cursor is in insert mode, the date and
  2030.     time are inserted into the text at the cursor, otherwise the date and
  2031.     time will overlay the text at the cursor. The date and time are
  2032.     entered in the following format:  MM/DD/YY HH:MMmm. For example,
  2033.     "08/30/93 01:01am".
  2034.  
  2035.   - exptab  TabWidth  "Expand Tabs"  <Ctrl-K-X>
  2036.  
  2037.     This command expands all the tab characters in the current Edit
  2038.     window. The tab width using during the expansion is determined by
  2039.     the "Tab Width" setting (see "Global Settings" 13-2). Acceptable
  2040.     values of "TabWidth" for this command are 1 through 64. Using a tab
  2041.     width of 1 converts tab characters (ascii 9) to spaces.
  2042.                                                       Undo and Redo   31
  2043.  
  2044.  
  2045.   6-4  Undo and Redo
  2046.   ──────────────────
  2047.  
  2048.   The undo and redo commands are a very advanced feature of The Aurora
  2049.   Editor. They allow you to backtrack and retrace modifications you made
  2050.   to the text in an Edit window. This can be an extremely valuable
  2051.   safeguard against accidental changes, or simply a convenient way for
  2052.   you to review your recent text changes.
  2053.  
  2054.   In general, all text changes, text folding, and block marking can be
  2055.   undone. Cursor movements and scrolling are also undone, but only when
  2056.   they are associated with text changes, text folding, and marking. Any
  2057.   change to the text in an Edit window can be undone, including block
  2058.   commands. Commands which can not be un-done are file saving commands,
  2059.   and commands which make changes directly to files via the File
  2060.   Manager.
  2061.  
  2062.   The following commands let you undo and redo changes to text:
  2063.  
  2064.   - undo  "Undo"  <Ctrl-U>
  2065.  
  2066.     This command will undo the last change you made to the text in the
  2067.     current Edit window. The text will be restored to its original state
  2068.     and the window and cursor will be positioned as they were before the
  2069.     change was made.
  2070.  
  2071.     Entering this command repeatedly will continue to undo text changes
  2072.     in the reverse order you made them. The configuration setting
  2073.     "UndoSize" determines the maximum number of changes which can be
  2074.     undone (see "Configuration - Editing Preferences" 17-8).
  2075.  
  2076.   - undo %r  "Redo"  <Ctrl-Y>
  2077.  
  2078.     This command will redo the last change that you have undone with the
  2079.     undo command in the current Edit window. Entering this command
  2080.     repeatedly will redo your text changes in the order you made them.
  2081.     Changes made with this command can also be undone with undo command.
  2082.  
  2083.  
  2084.   Note that both the undo and redo commands are "local" to the text in
  2085.   an Edit window. Entering either of these commands in one Edit window
  2086.   will only modify the text in another Edit window if the other Edit
  2087.   window is a copy of the original window.
  2088.                                                         OS Commands   32
  2089.  
  2090.  
  2091.   7-1  OS Commands
  2092.   ────────────────
  2093.  
  2094.   The Aurora Editor has three commands which allow you execute almost
  2095.   any DOS command or program from with the editor and then return you to
  2096.   your editing session. They are available from the "Macro" pulldown
  2097.   menu.
  2098.  
  2099.   In order to leave the maximum amount of memory available for DOS
  2100.   programs, The Aurora Editor will shrink down to 1.2K by swapping
  2101.   itself out to XMS or EMS memory (if available), or to disk.
  2102.  
  2103.   The OS commands are:
  2104.  
  2105.   - osshell  "OS Shell"  <F9>
  2106.  
  2107.     This command passes control to the DOS program "COMMAND.COM", and
  2108.     allows you to enter commands just as if you were in a normal DOS
  2109.     session. When you are in the DOS session, enter the "EXIT" command
  2110.     to return to the editor where you left it.
  2111.  
  2112.   - askoscmd %ck  "OS Command"  <Alt-F9>
  2113.  
  2114.     This command will prompt you to enter a DOS command, execute it, and
  2115.     then return you to the editor where you left it (there is no need to
  2116.     type "EXIT").
  2117.  
  2118.     Prompt history is available at this prompt (see "Prompts" 2-6).
  2119.  
  2120.   - askoscap  "OS Capture"  <Alt-F8>
  2121.  
  2122.     This command will prompt you to enter a DOS command, execute the
  2123.     command, and capture the output in a file. You will then be returned
  2124.     to the editor and the captured output will be displayed in an Edit
  2125.     window (there is no need to type "EXIT").
  2126.  
  2127.     This command is especially helpful when used with the "finc"
  2128.     <Alt-F7> command ("Go to Compiler Error" on the "Search" pull-down
  2129.     menu). You can use the "askoscap" command to capture the output from
  2130.     a compiler, and then use the "finc" <Alt-F7> command to locate
  2131.     compiler errors in your source code (see the "finc" command 6-1).
  2132.  
  2133.     Prompt history is available at this prompt (see "Prompts" 2-6).
  2134.                                                         OS Commands   33
  2135.  
  2136.   - os  [DOS command]  [options]
  2137.  
  2138.     This command executes the specified DOS command without prompting
  2139.     you for the command. You can specify any of the following options:
  2140.  
  2141.       c - clear the screen before executing the command
  2142.       k - display the prompt "Press any key to return" when done
  2143.  
  2144.     For example:
  2145.  
  2146.       os %dir %kc
  2147.  
  2148.     The command above clears the screen, executes the DOS "dir" command,
  2149.     and then prompts you to return to the editor.
  2150.  
  2151.   - oscap  [DOS command]  [options]
  2152.  
  2153.     This command executes the specified DOS command without prompting
  2154.     you for the command, and directs the output to a file. You can
  2155.     specify the "k" option (see the "os" command above).
  2156.  
  2157.  
  2158.   Note: You should not execute any DOS "terminate and stay resident"
  2159.   programs (such as the DOS "print" command) from within any of the above
  2160.   commands. "Terminate and stay resident" programs should be started
  2161.   before the editor is started.
  2162.                                                 Using Marked Blocks   34
  2163.  
  2164.  
  2165.   8-1  Using Marked Blocks
  2166.   ────────────────────────
  2167.  
  2168.   Marking blocks of text and executing block commands are essential
  2169.   features of many text editors. A block mark is an area of text in an
  2170.   Edit window which has been designated for a specific block command.
  2171.   Unlike the clipboard commands (see "The Clipboard" 9-1), block
  2172.   commands directly manipulate Edit window text.
  2173.  
  2174.   The Aurora Editor provides commands to define block marks by lines,
  2175.   columns, and characters (streams), and also provides a large set of
  2176.   block commands. There are block commands for copying, moving,
  2177.   deleting, overlaying, reflowing text, and more.
  2178.  
  2179.   Before you can use a block command, you must first create a block
  2180.   mark. The Aurora Editor has several different commands for creating
  2181.   block marks:
  2182.  
  2183.  
  2184.   - mset %l  "Mark Line"  <Alt-L>
  2185.  
  2186.     This command creates a new "line" mark or adjusts the size of an
  2187.     existing line mark. A line mark designates a group of one or more
  2188.     complete lines without specifying any column information. To mark a
  2189.     group of lines, just move the cursor to one end of the group of
  2190.     lines to be marked and enter this command, then move the cursor to
  2191.     the other end and enter this command again. The new line mark will
  2192.     be highlighted.
  2193.  
  2194.     To create a line mark using the mouse, double-click the left mouse
  2195.     button on one end of the group of lines to be marked, and with left
  2196.     mouse button still down, drag the mouse to the other end of the
  2197.     group of lines and then release the left mouse button.
  2198.  
  2199.     Note: A line mark can also be created by holding down the left
  2200.     <Shift> key and using the cursor keys to size the mark.
  2201.  
  2202.   - mset %r  "Mark Column"  <Alt-B>
  2203.  
  2204.     This command creates a new rectangular or "column" mark. It can also
  2205.     adjust the size of an existing column mark. A column mark designates
  2206.     rectangular area of text which spans one or more lines and one or
  2207.     more columns. To create a column mark, move the cursor to one corner
  2208.     of the desired rectangle and enter this command, then move the
  2209.     cursor to the opposite corner of the rectangle and enter this
  2210.     command again. The new column mark will be highlighted.
  2211.  
  2212.     To create a column mark using the mouse, press the left mouse button
  2213.     down at one end of the rectangle to be marked, and with left mouse
  2214.     button still down, drag the mouse to the opposite corner of the
  2215.     rectangle and release the left mouse button.
  2216.                                                 Using Marked Blocks   35
  2217.  
  2218.  
  2219.   - mset %s  "Mark Character"  <Alt-A>
  2220.  
  2221.     This command creates a new stream or "character" mark. It can also
  2222.     adjust the size of an existing character mark. A character mark
  2223.     designates a continuous segment or "stream" of characters in the
  2224.     file. To create a character mark, move the cursor to the beginning
  2225.     of the character stream and enter this command, then move the cursor
  2226.     to the end of the character stream and enter this command again. The
  2227.     new character mark will be highlighted.
  2228.  
  2229.     Note: A character mark can also be created by holding down the right
  2230.     <Shift> key and using the cursor keys to size the mark.
  2231.  
  2232.   - mdes  "Unmark"  <Alt-U>
  2233.  
  2234.     This command will unmark the current marked block.
  2235.  
  2236.  
  2237.   Note: the "MouMrkS" and "MouMrkD" configuration settings (see
  2238.   "Configuration - Mouse" 17-3) determine the default type of block
  2239.   marks created by single-clicking and double-clicking the left mouse
  2240.   button and dragging the mouse. No matter what "MouMrkS" and "MouMrkD"
  2241.   are set to, you can still always create the desired line, column, or
  2242.   character mark by holding down the appropriate "shift" key when
  2243.   single-clicking or double-clicking the left mouse button and dragging
  2244.   the mouse:
  2245.  
  2246.     <Alt>   - forces line marks
  2247.     <Ctrl>  - forces column marks
  2248.     <Shift> - forces character (stream) marks
  2249.  
  2250.  
  2251.   There are some "short-cut" block marking commands for defining
  2252.   commonly used line and column marks, which can save you time:
  2253.  
  2254.   - mpgh %tb  "Mark Paragraph"  <Alt-3>
  2255.  
  2256.     This command creates a line mark which spans the "paragraph" in
  2257.     which the cursor is located. A paragraph is defined as a contiguous
  2258.     series of non-blank lines.
  2259.  
  2260.   - wrdmrk CSet  "Mark Word"  <Alt-1>
  2261.  
  2262.     This command creates a column mark which spans the "word" in which
  2263.     the cursor is located. The configuration setting "CSet" is the
  2264.     character set used to define a word for this command (see
  2265.     "Configuration - Character Sets" 17-14).
  2266.  
  2267.   - meol  "Mark to EOL"  <Alt-2>
  2268.  
  2269.     This command creates a column mark which spans the text from the
  2270.     current cursor position to the end of the line.
  2271.                                                 Using Marked Blocks   36
  2272.  
  2273.  
  2274.   The following block commands can be used with all marked blocks
  2275.   created by the methods described above. Note that the effects of all
  2276.   these commands can be reversed with the "undo" <Ctrl-U> command.
  2277.  
  2278.   - mcpy  "Copy"  <Alt-C>
  2279.  
  2280.     This commands inserts a copy of the text in the current marked block
  2281.     after the cursor. The original marked block remains unchanged. You can
  2282.     copy a marked block within the same Edit window, or between different
  2283.     Edit windows.
  2284.  
  2285.     The configuration setting "MoveMark" determines whether or not the
  2286.     block mark highlight is moved to the location where the text was
  2287.     copied (see "Configuration Settings - Editing Preferences" 17-8).
  2288.  
  2289.     Note: this command can also be used to duplicate the line at the
  2290.     cursor if no marked block currently exists and the "CopyLine"
  2291.     configuration setting is ON.
  2292.  
  2293.   - mcpyp  <Alt-C>
  2294.  
  2295.     This command is for use within an editor prompt. It copies the text
  2296.     in the current marked block to the cursor location within the
  2297.     prompt. Only column marks (or the first line of a stream mark) are
  2298.     copied. Line marks are ignored.
  2299.  
  2300.   - mmov  "Move"  <Alt-M>
  2301.  
  2302.     This command moves the text in the current marked block (and the
  2303.     marked block itself) after the cursor. The marked block may be in
  2304.     the current Edit window or in another Edit window.
  2305.  
  2306.   - mdel  "Delete"  <Alt-D>
  2307.  
  2308.     This command deletes the text in the current marked block, and the
  2309.     marked block itself. The marked block may be in the current Edit
  2310.     window, or in a another Edit window. Note that you can restore the
  2311.     marked block again with the "undo" <Ctrl-U> command.
  2312.  
  2313.     Note: this command can also be used to delete the line at the cursor
  2314.     if no marked block currently exists and the "DelLine" configuration
  2315.     setting is ON.
  2316.  
  2317.   - askmfill  "Fill"  <Ctrl-K-F>
  2318.  
  2319.     This command prompts you to enter a character, and then fills the
  2320.     marked block with the character you specified. If the marked block
  2321.     is a line mark, only the area between the left and right margins
  2322.     is filled.
  2323.                                                 Using Marked Blocks   37
  2324.  
  2325.  
  2326.   - msave  "Save.."  <Ctrl-K-S>
  2327.   - msave %a
  2328.  
  2329.     These commands prompt you for a filename, and then save the current
  2330.     marked block in the file you specified. If option "a" is specified,
  2331.     the block is always appended to the file, otherwise you will be
  2332.     prompted to replace the file or append to the file (if it exists).
  2333.  
  2334.     If the file containing the marked block is a binary file, then no
  2335.     line delimiter is used when saving, otherwise each saved line in the
  2336.     block is appended with the current value of the line delimiter
  2337.     "LineDlm" configuration setting.
  2338.  
  2339.     Note: you cannot use the "undo" <Ctrl-U> command to reverse the
  2340.     effects of this command.
  2341.  
  2342.   - mcase %l  "Lowercase"
  2343.   - mcase %u  "Uppercase"  <Ctrl-K-U>
  2344.  
  2345.     These commands will convert all characters in the current marked
  2346.     block to lower case or upper case.
  2347.  
  2348.   - mcase %ul
  2349.  
  2350.     This command will "flip" or toggle the case of all characters in the
  2351.     current marked block.
  2352.  
  2353.  
  2354.   The following block commands work only on line and column blocks:
  2355.  
  2356.   - mmov %o  "Overlay"  <Alt-O>
  2357.  
  2358.     This command overlays the text at the cursor with the text in the
  2359.     current marked block. The original marked block remains unchanged
  2360.     (if it does not overlap the destination). You can overlay a marked
  2361.     block within the same Edit window, or between different Edit
  2362.     windows.
  2363.  
  2364.     The configuration setting "MoveMark" determines whether or not the
  2365.     block mark highlight is moved to the location where the text was
  2366.     overlaid (see "Configuration Settings - Editing Preferences" 17-8).
  2367.  
  2368.   - mmov %of  "Move Over"  <Ctrl-M>
  2369.  
  2370.     This command moves the text in the current marked block over the
  2371.     text at the cursor. The original marked block is blanked-out (or
  2372.     partially blanked-out if it overlaps with new block at the cursor).
  2373.     You can use this command inside the same Edit window, or between
  2374.     different Edit windows.
  2375.  
  2376.   - mshf  1    "Indent"    <Shift-F8>
  2377.   - mshf -1    "Unindent"  <Shift-F7>
  2378.  
  2379.     These commands shift the text in the current marked block left or
  2380.     right one column. They are useful for indenting or unindenting areas
  2381.     of text.
  2382.                                                 Using Marked Blocks   38
  2383.  
  2384.  
  2385.   - mjust %l  "Left Justify"
  2386.   - mjust %c  "Center"        <Ctrl-K-C>
  2387.   - mjust %r  "Right Justify"
  2388.  
  2389.     These commands left justify, center, and right justify the text in
  2390.     the current marked block. For line blocks, the current Left and
  2391.     Right margins are used. For column marks, the left and right edges
  2392.     of the mark are used as left and right margins. The centering
  2393.     command is useful for creating centered document titles.
  2394.  
  2395.   - mrfl %b  "Reflow"  <Alt-R>
  2396.  
  2397.     This useful command will "reflow" the text within the current marked
  2398.     block. If the marked block is a line mark, the marked text will be
  2399.     reflowed to fit between the Left and Right Margins. The reflowed
  2400.     text will always be left justified.
  2401.  
  2402.     If the marked block is a column mark, all the lines spanned by the
  2403.     column mark will still be reflowed as with line marks, but the left
  2404.     and right edges of the mark will be used as Left and Right margins.
  2405.  
  2406.     If the "AutoMark" configuration setting is set to "ptb" (paragraph
  2407.     top-to-bottom), you can the reflow a paragraph by simply placing the
  2408.     cursor within the paragraph and entering this command (see
  2409.     "Configuration - Editing Preferences" 17-8). In this case, the
  2410.     cursor position is used as the left margin, and the Right Margin
  2411.     setting is used as the right margin.
  2412.  
  2413.   - mrfl %br  "Reflow RJust"  <Alt-Y>
  2414.  
  2415.     This command will reflow text in the same way as the "mrfl %b"
  2416.     <Alt-R> command above, but the reflowed text will be both left AND
  2417.     right justified. The editor may insert spaces between some words in
  2418.     the text to pad the line out to the right margin.
  2419.  
  2420.   - msrt  "Sort"  <Ctrl-K-O>
  2421.  
  2422.     This command sorts the all the lines spanned by the current marked
  2423.     block. For line marks, the entire line is used as the sort key. For
  2424.     column marks, the area between the left and right edges of the mark
  2425.     is used as the sort key. Note that for column marks, all the lines
  2426.     spanned by the mark will still be sorted, not just the area within
  2427.     the mark.
  2428.  
  2429.     If Scroll Lock is ON when this command is executed, the sort is in
  2430.     descending order, otherwise the sort is in ascending order.
  2431.  
  2432.     If the cursor Insert Mode is ON when this command is executed, the
  2433.     sort is case-insensitive, otherwise the sort is case-sensitive.
  2434.  
  2435.                                                 Using Marked Blocks   39
  2436.  
  2437.  
  2438.   - print %m  "Print Block"  <Alt-P>
  2439.  
  2440.     This command prints the text within the current marked block using
  2441.     the current printer settings (see "Configuration - Print Settings"
  2442.     17-10).
  2443.                                                       The Clipboard   40
  2444.  
  2445.  
  2446.   9-1  The Clipboard
  2447.   ──────────────────
  2448.  
  2449.   Edit window text can be indirectly manipulated by using the clipboard
  2450.   commands. These commands allow you to move or copy the text within the
  2451.   current marked block into a temporary buffer known as a "clipboard",
  2452.   and then copy or overlay the clipboard text to a new location in the
  2453.   same Edit window, or even to a new location in a different Edit
  2454.   window. As with the block commands, you can use the "undo" <Ctrl-U>
  2455.   command to reverse the effects of clipboard commands.
  2456.  
  2457.   You can have any number of clipboards in an edit session. Each
  2458.   clipboard is identified by a unique name and is available to any Edit
  2459.   window. The default clipboard is named "clipboard", and is the
  2460.   "current" clipboard when The Aurora Editor is initially started.
  2461.  
  2462.   Note that if the "AutoMark" configuration setting (see "Configuration
  2463.   - Editing Preferences" 17-8) is set to "ptb" (paragraph), you can
  2464.   "Cut" or "Copy" a paragraph by simply placing the cursor within the
  2465.   paragraph and entering one of the "clpcpy" commands described below.
  2466.  
  2467.   The following clipboard commands operate on the "current" clipboard:
  2468.  
  2469.   - clpcpy %d  "Cut"  <Grey->
  2470.  
  2471.     This command erases the contents of the current clipboard and then
  2472.     moves the text within the current marked block to the clipboard. The
  2473.     current marked block is destroyed.
  2474.  
  2475.   - clpcpy %ad  "Cut Append"  <Ctrl-Grey->
  2476.  
  2477.     This command moves the text within the current marked block to the
  2478.     end of the current clipboard without erasing the contents of the
  2479.     clipboard. The current marked block is destroyed.
  2480.  
  2481.     This command is useful for gathering separate blocks of text and
  2482.     grouping them together in the clipboard.
  2483.  
  2484.   - clpcpy  "Copy"  <Grey+>
  2485.  
  2486.     This command erases the contents of the current clipboard and then
  2487.     copies the text within the current marked block into the clipboard.
  2488.     The current marked block and its contents are unchanged.
  2489.                                                       The Clipboard   41
  2490.  
  2491.  
  2492.   - clpcpy %a  "Copy Append"  <Ctrl-Grey+>
  2493.  
  2494.     This command copies the text within the current marked block to the
  2495.     end of the current clipboard without erasing the contents of the
  2496.     clipboard. The current marked block and its contents are unchanged.
  2497.  
  2498.     This command is useful for copying separate blocks of text and
  2499.     grouping them together in the clipboard.
  2500.  
  2501.   - clppst  "Paste"  <Grey*>
  2502.  
  2503.     This command inserts the text from the current clipboard at the
  2504.     cursor position in the current Edit window. The contents of the
  2505.     clipboard are unchanged.
  2506.  
  2507.   - clppst %o  "Paste Over"  <Ctrl-Grey*>
  2508.  
  2509.     This command overlays the text from the current clipboard at the
  2510.     cursor position in the current Edit window. The contents of the
  2511.     clipboard are unchanged.
  2512.  
  2513.   - clpclr  "Clear"  <Ctrl-Grey/>
  2514.  
  2515.     This command erases the contents of the current clipboard.
  2516.  
  2517.  
  2518.   The following command changes the "current" clipboard:
  2519.  
  2520.   - askclp  "Clipboard.."
  2521.  
  2522.     This command prompts you for a unique clipboard name and changes the
  2523.     "current" clipboard to the name you enter. The clipboard will be
  2524.     created if it does not exist. Entering any of the above clipboard
  2525.     commands will now refer to the new clipboard.
  2526.  
  2527.     At installation, the default clipboard name is "clipboard".
  2528.                                                        Folding Text   42
  2529.  
  2530.  
  2531.   10-1  Folding Text
  2532.   ──────────────────
  2533.  
  2534.   The Aurora Editor allows you to "fold" multiple lines of text in an
  2535.   Edit window and make them appear as one line. This feature is useful
  2536.   for hiding lines of text that you do not wish to view, and may help to
  2537.   reduce unnecessary scrolling. If you wish to redisplay the folded
  2538.   text, it can be "unfolded" at any time. You can create any number of
  2539.   text folds of any size.
  2540.  
  2541.   A text fold is displayed in an Edit window as a single highlighted
  2542.   line indicating the number of lines in the fold. For example:
  2543.  
  2544.     ── 215 lines not displayed ─────────────────────────────────────
  2545.  
  2546.   In the example above, 215 lines of text appear as one folded line.
  2547.  
  2548.   Text folds can be "nested" by folding a group of lines which already
  2549.   contain other folds. Later when the outer fold is unfolded, the inner
  2550.   folds are redisplayed. This feature allows you to create a "hierarchy
  2551.   of folds". Fold hierarchies of any size can be created.
  2552.  
  2553.   Note that any lines contained within a text fold will be excluded from
  2554.   the search and replace commands (see "Search and Replace" 11-1).
  2555.  
  2556.   Several commands are available for folding and unfolding text. The
  2557.   effects of each of these commands can be reversed with the "undo"
  2558.   <Ctrl-U> and "undo %r" <Ctrl-Y> commands:
  2559.  
  2560.   - lfld %b  "Fold Next Line"  <Alt-8>
  2561.   - lfld %t  "Fold Prev Line"
  2562.  
  2563.     These commands extend the fold at the cursor to the next or previous
  2564.     line. If there is no fold at the cursor, then a new "one-line" fold
  2565.     is created at the cursor.
  2566.  
  2567.   - mfld %f  "Fold Block"  <Alt-F>
  2568.  
  2569.     This command creates a new fold consisting of all the lines in the
  2570.     current marked block. Any "sub-folds" will be preserved.
  2571.  
  2572.     If the "AutoMark" configuration setting is set to "ptb" (paragraph),
  2573.     you can fold a paragraph by simply placing the cursor within the
  2574.     paragraph and entering this command (see "Configuration - Editing
  2575.     Preferences" 17-8).
  2576.                                                        Folding Text   43
  2577.  
  2578.  
  2579.   - mfld %uaf  "Fold Block Flat"
  2580.  
  2581.     This command is identical the "mfld %f" command above, except that
  2582.     all existing folds within the marked block are removed before the
  2583.     new fold is created. The new fold will not have any "sub-folds".
  2584.  
  2585.   - lfld %u  "Unfold Line"  <Alt-G>
  2586.  
  2587.     This command removes the fold at the cursor.
  2588.  
  2589.   - lfld %ua  "Unfold Line Flat"
  2590.  
  2591.     This command removes the fold at the cursor, and also removes any
  2592.     "sub-folds" within the fold.
  2593.  
  2594.   - lfld %bs  "Unfold Next Line"  <Alt-9>
  2595.   - lfld %ts  "Unfold Prev Line"
  2596.  
  2597.     These commands shrink the fold at the cursor so that the bottom or
  2598.     top line in the fold is displayed.
  2599.  
  2600.   - mfld %u  "Unfold Block"
  2601.  
  2602.     This command removes any "top-level" folds contained within the
  2603.     current marked block. Folds contained within the top-level folds are
  2604.     preserved.
  2605.  
  2606.   - mfld %ua  "Unfold Block Flat"
  2607.  
  2608.     This command removes all folds contained within the current marked
  2609.     block. All existing fold hierarchies within the marked block are
  2610.     removed.
  2611.  
  2612.   - mflda %ua  "Unfold All"  <Alt-0>
  2613.  
  2614.     This command removes all folds in the current Edit window. All
  2615.     existing fold hierarchies are removed.
  2616.                                                  Search and Replace   44
  2617.  
  2618.  
  2619.   11-1  Search and Replace
  2620.   ────────────────────────
  2621.  
  2622.   The Aurora Editor provides commands for locating character strings
  2623.   within the current Edit window, or within files on disk:
  2624.  
  2625.   - askfind  "Find.."  <F5>, <Ctrl-F>
  2626.  
  2627.     This command prompts you for a character string to search for in
  2628.     the current Edit window. "Search options" can also be specified at
  2629.     the prompt. The following search options are available:
  2630.  
  2631.     i - Ignore case when searching for the string. For example, the
  2632.         search string "aurora" would find "Aurora" or "AURORA".
  2633.  
  2634.     w - Search for "whole words only". For example, the search string
  2635.         "at" would find " at " and "(at)", but not "ate" or "that". This
  2636.         option can be useful for locating variables in program source
  2637.         code.
  2638.  
  2639.     r - Reverse search. This option forces the search to proceed toward
  2640.         the top of the Edit window. If this option is not specified, the
  2641.         search proceeds toward the bottom of the Edit window.
  2642.  
  2643.     b - Marked block only. This option limits the search to the current
  2644.         marked block. The block may be a line mark or a column mark.
  2645.  
  2646.     g - Search globally starting from the beginning of the file (or the
  2647.         end of the file if used with the reverse search option). If this
  2648.         option is not selected, the search begins from the current
  2649.         cursor position. This option is ignored if the "Marked block
  2650.         only" option (b) is specified.
  2651.  
  2652.     If you have tailored the find prompt to appear as a dialog box, you
  2653.     can select these options from the "search options" group box. You
  2654.     can also configure which options default to "selected" when the
  2655.     dialog box is displayed (see the "SearchOpt" configuration setting
  2656.     17-8).
  2657.  
  2658.     If you have tailored the find prompt to appear as a command line or
  2659.     one-line box, enter the search string at the prompt and press the
  2660.     <Enter> key. For example, to find the string "Aurora":
  2661.  
  2662.       (string/iwrbg) Find> Aurora  <Enter>
  2663.                                                  Search and Replace   45
  2664.  
  2665.  
  2666.     If you are entering search options, enter the slash character (/)
  2667.     after the search string and then enter the desired search options:
  2668.  
  2669.       (string/iwrbg) Find> Aurora/iwrb  <Enter>
  2670.  
  2671.     After the <Enter> key pressed in the example above, the editor will
  2672.     search for the string "Aurora". The search will ignore case and will
  2673.     be restricted to the current marked block, starting at the bottom of
  2674.     the marked block and searching toward the top.
  2675.  
  2676.     If you need to include the slash character (/) in the search string,
  2677.     enter it twice. For example:
  2678.  
  2679.       (string/iwrbg) Find> Au//r//ora/iwrb  <Enter>
  2680.  
  2681.     In the example above, the search string is now "Au/r/ora". Note that
  2682.     double slashes are only required in one-line boxes or command line
  2683.     prompts, not in dialog boxes.
  2684.  
  2685.     If you have tailored the find prompt to appear as a command line or
  2686.     one-line box, default search options will be added by the editor if
  2687.     you have not specified any search options in the prompt (see the
  2688.     "SearchOpt" configuration setting 17-8). To prevent default search
  2689.     options from being added, either specify your own options or just
  2690.     add a "/" to the end of the search string.
  2691.  
  2692.     Prompt history is available at the find prompt (see "Prompts" 2-6).
  2693.     Note that the Find, Replace, and Scan prompts all share the same
  2694.     prompt history.
  2695.  
  2696.  
  2697.   - askrpl  "Replace.."  <Ctrl-G>
  2698.  
  2699.     This command prompts you for a character string to search for in the
  2700.     current Edit window, and a character string to replace it with.
  2701.     "Search options" can also be specified. The search options are the
  2702.     same as the search options specified for the "askfind" command (see
  2703.     above).
  2704.  
  2705.     The following "replace option" may also be specified:
  2706.  
  2707.       a - Replaces all occurrences of the search string that are found.
  2708.           A message will tell you how many replacements were made.
  2709.  
  2710.     If the replace option "a" is not specified, then you will be
  2711.     prompted to verify each replacement. Each time the search string is
  2712.     found, the following prompt will appear on the window title bar:
  2713.  
  2714.       Replace (Yes/No/All/One/Reverse/Quit)?
  2715.                                                  Search and Replace   46
  2716.  
  2717.  
  2718.     You can select one of the replace/verify options by entering the
  2719.     first character of the desired option:
  2720.  
  2721.       - y (Yes)      Replace and continue searching
  2722.       - n (No)       Do not replace and continue searching
  2723.       - a (All)      Replace all remaining occurrences without prompting
  2724.       - o (One)      Replace and do not continue searching
  2725.       - r (Reverse)  Do not replace and change the search direction
  2726.       - q (Quit)     Cancel the search
  2727.  
  2728.     Entering any other character or function key will cancel the search.
  2729.  
  2730.  
  2731.     Note that any string replacements made with this command can be
  2732.     reversed with the "undo" <Ctrl-U> and "undo %r" <Ctrl-Y> commands.
  2733.  
  2734.     If you have tailored the replace prompt to appear as a dialog box,
  2735.     you can select these options from the "replace options" group box.
  2736.     You can also configure which options default to "selected" when the
  2737.     dialog box is displayed (see the configuration settings "SearchOpt"
  2738.     and "ReplaceOpt" 17-8).
  2739.  
  2740.     If you have tailored the replace prompt to appear as a command line
  2741.     or one-line box, enter the search string at the prompt followed by
  2742.     the slash character (/), replace string, and another slash
  2743.     character. Then press the <Enter> key. For example:
  2744.  
  2745.       (string/repl/iwrbga) Repl> editor/Aurora/  <Enter>
  2746.  
  2747.     In the example above the editor will replace the first occurrence of
  2748.     the string "editor" with the string "Aurora". Note that the
  2749.     terminating slash is required.
  2750.  
  2751.     Search and replace options can be entered after the last slash (/)
  2752.     character. For example:
  2753.  
  2754.       (string/repl/iwrbga) Repl> editor/Aurora/irga  <Enter>
  2755.  
  2756.     In the example above, the editor will replace all occurrences of the
  2757.     string "editor" (ignoring case) with the string "Aurora". The search
  2758.     will proceed from the bottom of the file to the top of the file and
  2759.     you will not be prompted for any replacement.
  2760.  
  2761.     If you need to include the slash character (/) in the search string
  2762.     or replace string, enter it twice. For example:
  2763.  
  2764.       (string/repl/iwrbga) Repl> edi//tor/Aur//ora/  <Enter>
  2765.                                                  Search and Replace   47
  2766.  
  2767.  
  2768.     In the example above, the search string is "edi/tor" and the replace
  2769.     string is "Aur/ora". Note that double slashes are only required in
  2770.     one-line boxes or command line prompts, not in dialog boxes.
  2771.  
  2772.     If you would like to replace the search string with a "null" replace
  2773.     string, specify the "z" replace option without specifying a replace
  2774.     string. For example:
  2775.  
  2776.       (string/repl/iwrbga) Repl> xyz/za  <Enter>
  2777.  
  2778.     In the example above, the editor will delete all occurrences of the
  2779.     string "xyz" from the cursor position to the end of the file.
  2780.  
  2781.     If you have tailored the replace prompt to appear as a command line
  2782.     or one-line box, and you have not specified any search or replace
  2783.     options, then the default search and replace options will be added
  2784.     by the editor (see the "SearchOpt" configuration setting 17-8). To
  2785.     prevent default options from being added, either specify your own
  2786.     options, or specify the "n" option ("no default").
  2787.  
  2788.     If you have tailored the Find prompt to appear as a command-line or
  2789.     one-line box prompt, you can also enter any replace command in the
  2790.     Find prompt. This allows you to enter both Find and Replace commands
  2791.     from only one prompt.
  2792.  
  2793.     Prompt history is available at the replace prompt (see "Prompts"
  2794.     2-6). Note that the Find, Replace, and Scan prompts all share the
  2795.     same prompt history.
  2796.  
  2797.   - finl  "Repeat Last Find/Repl"  <Ctrl-L>
  2798.  
  2799.     This command will repeat the last find or replace command you
  2800.     entered, without prompting you for search or replace strings.
  2801.  
  2802.   - search  [search string]  [options]
  2803.  
  2804.     This command is used to perform the search and replace commands
  2805.     without prompting. The search string must be specified in the same
  2806.     way as it would be specified for the search and replace command line
  2807.     or one-line box prompts (see above). Specifying the "r" option adds
  2808.     the search string to the search prompt history. For example:
  2809.  
  2810.       search "abc/i" %r.
  2811.  
  2812.     The above command searches for the string "abc" (ignoring case) in
  2813.     the current Edit window, and adds the search string to the search
  2814.     prompt history.
  2815.                                                  Search and Replace   48
  2816.  
  2817.  
  2818.   - askscan  "Scan Files.."  <Ctrl-S>
  2819.  
  2820.     This command allows you to scan a directory (or a group of files
  2821.     designated by a "wildcards") for a character string. You will be
  2822.     prompted for the directory or wildcard file specification, and for a
  2823.     search string and search options. The "Ignore Case" (i) and "Whole
  2824.     Words" (w) search options can be used with this command (see the
  2825.     "askfind" command above for a description of these search options).
  2826.  
  2827.     After the scan has completed, a File Manager window will be
  2828.     displayed showing all the files in which the search string was
  2829.     found. Position the cursor to the file you wish to edit and press
  2830.     <Enter> or double-click the left mouse button if you are using the
  2831.     mouse. The file will be loaded into an Edit window and the cursor
  2832.     will be positioned at the first occurrence of the matched search
  2833.     string. You can use the "finl" <Ctrl-L> command ("Repeat Last
  2834.     Find/Repl" - see above) to find other occurrences.
  2835.  
  2836.     If you have tailored the scan prompt to appear as a dialog box, you
  2837.     can select scan search options from the "search options" group box.
  2838.     You can also configure which search options default to "selected"
  2839.     when the dialog box is displayed (see the configuration setting
  2840.     "SearchOpt" 17-8).
  2841.  
  2842.     If you have tailored the scan prompt to appear as a command line or
  2843.     one-line box, enter search string at the scan prompt:
  2844.  
  2845.       (string/files/iw) Scan> Aurora  <Enter>
  2846.  
  2847.     In the above example, the editor will search all files in the
  2848.     current directory for the string "Aurora". Consider the following
  2849.     example:
  2850.  
  2851.       (string/files/iw) Scan> Aurora/c:\doc\*.txt  <Enter>
  2852.  
  2853.     In this example, the editor will search all files with the extension
  2854.     ".txt" in the directory "c:\doc" for the string "Aurora". Now
  2855.     consider the following example:
  2856.  
  2857.       (string/files/iw) Scan> Aurora/*.doc/i  <Enter>
  2858.  
  2859.     In this example, the editor will search all files in the current
  2860.     directory with the extension .DOC for the string "Aurora",
  2861.     ignoring case during the search.
  2862.  
  2863.     As with the "askfind" command above, if you need to include the
  2864.     slash character (/) in the search string, enter it twice. Note that
  2865.     double slashes are only required in one-line boxes or command line
  2866.     versions of the scan prompt, not in dialog boxes.
  2867.                                                  Search and Replace   49
  2868.  
  2869.  
  2870.     If you have tailored the scan prompt to appear as a command line or
  2871.     one-line box, default search options will be added by the editor if
  2872.     you have not specified any search options (see the "SearchOpt"
  2873.     configuration setting 17-8)
  2874.  
  2875.     Note that you can use the <Ctrl-Break> key to interrupt the
  2876.     execution of the "askscan" <Ctrl-S> command.
  2877.  
  2878.     Prompt history is available at the Scan prompt (see "Prompts" 2-6).
  2879.     Note that the Find, Replace, and Scan prompts all share the same
  2880.     prompt history.
  2881.                                                            Printing   50
  2882.  
  2883.  
  2884.   12-1  Printing
  2885.   ──────────────
  2886.  
  2887.   The Aurora Editor provides commands for printing the contents of the
  2888.   current window, or printing a marked block of text within an Edit
  2889.   window. Using the File Manager, you can mark groups of files for
  2890.   printing and print directory listings (see "The File Manager" 16-1).
  2891.  
  2892.   Print commands will use the current printer settings to format output
  2893.   to the printer (see "Configuration - Print Settings" 17-11). The
  2894.   following print commands are available:
  2895.  
  2896.   - print     "Print" <Ctrl-P>  (Edit window)
  2897.   - print %d  "Print" <Ctrl-P>  (File Manager window)
  2898.  
  2899.     These commands print the entire contents of an Edit window or File
  2900.     Manager window using the current printer settings. Printing can be
  2901.     aborted by pressing <Ctrl-Break>.
  2902.  
  2903.   - print %m  "Print Block"  <Alt-P>
  2904.  
  2905.     This command prints the current marked block using the current
  2906.     printer settings. The marked block need not reside in the current
  2907.     window. Printing can be aborted by pressing <Ctrl-Break>.
  2908.  
  2909.   - prtstr (byte 12)  "Print Formfeed"
  2910.  
  2911.     This command ejects a page by sending a formfeed character (ascii
  2912.     12) to the printer defined in the current printer settings. The
  2913.     "prtstr" command can be used to send any control character sequence
  2914.     to the printer. For example:
  2915.  
  2916.       prtstr (byte 13 10)
  2917.  
  2918.     The above command sends a carriage return (ascii 13) and linefeed
  2919.     (ascii 10) to the printer.
  2920.  
  2921.   - prtfil  [filename]
  2922.  
  2923.     This command prints the contents of the specified filename, using
  2924.     the current printer settings. Printing can be aborted by pressing
  2925.     <Ctrl-Break>.
  2926.                                                            Printing   51
  2927.  
  2928.  
  2929.   - askprtset  "Print Settings.."
  2930.  
  2931.     This command displays a dialog box which allows you to change the
  2932.     current printer settings. You can change any of the following
  2933.     settings:
  2934.  
  2935.     - printer options, including header, footer, page numbers, line
  2936.         numbers, eject when done
  2937.     - printer output device or file
  2938.     - lines per page
  2939.     - line spacing
  2940.     - number of copies
  2941.     - printer initialization string
  2942.     - top, bottom, left, and right margins
  2943.  
  2944.     For more information on printer settings, see "Configuration -
  2945.     Print Settings" (17-10).
  2946.                                                     Window Settings   52
  2947.  
  2948.  
  2949.   13-1  Window Settings
  2950.   ─────────────────────
  2951.  
  2952.   For each Edit window in The Aurora Editor there are settings such as
  2953.   "Word Wrap" and "Line Draw" which can be switched ON or OFF during an
  2954.   edit session. You can switch these settings ON or OFF from the
  2955.   "Settings" pull-down menu, or you can define keys which toggle the
  2956.   settings.
  2957.  
  2958.   Each Edit window has it's own copy of these settings, so that changing
  2959.   a setting in one Edit window does not affect the settings of another
  2960.   Edit window. This feature can very convenient when you switch back and
  2961.   forth often between two or more Edit windows and you don't want to
  2962.   keep changing the settings every time you switch windows (for example,
  2963.   editing program source code in one window with "Word Wrap" OFF, and
  2964.   documentation in another window with "Word Wrap" ON).
  2965.  
  2966.   If the configuration setting "SaveWin" is ON, then window settings for
  2967.   each file you edit are "remembered" across edit sessions (see
  2968.   "Configuration - Desktop Options" 17-11). When you close an Edit
  2969.   window, these settings are saved along with the window sizes and
  2970.   cursor positions. The window settings are restored the next time the
  2971.   file is edited.
  2972.  
  2973.   The following section describes the settings associated with each Edit
  2974.   window. Each setting is listed in the following format:
  2975.  
  2976.     togglecommand  "menu item"  <key>
  2977.  
  2978.   The "togglecommand" is the command used to toggle the ON/OFF state of
  2979.   the setting. The "menu item" is the description of the setting as it
  2980.   appears on the "Set" pull-down menu. <key> is the default key used to
  2981.   toggle the setting (if any).
  2982.  
  2983.  
  2984.   - wmwrap  "Word Wrap"  <Ctrl-W>
  2985.  
  2986.     This setting is useful for word processing. It allows you to type
  2987.     freely without having to press <Enter> at the end of each line.
  2988.  
  2989.     If this setting is ON, and you are typing beyond the Right Margin, a
  2990.     new line is inserted after the current line, and the word you are
  2991.     currently typing (and any characters following it) are moved to the
  2992.     next line. If the "AutoIndent" Window Setting is ON, the beginning
  2993.     of the new line is aligned with the first non-blank character of the
  2994.     previous line, otherwise the new line begins at column 1. The cursor
  2995.     is placed in the same relative position in the word as it was on the
  2996.     previous line.
  2997.                                                     Window Settings   53
  2998.  
  2999.  
  3000.   - wmautoi  "AutoIndent"
  3001.  
  3002.     This setting is useful for word processing and general editing. It
  3003.     aligns the beginning of newly inserted lines with the previous line
  3004.     or next line, thus saving you keystrokes.
  3005.  
  3006.     If this setting is ON and a new line is inserted, the cursor is
  3007.     moved to the first non-blank column of the previous line. If the
  3008.     previous line is blank, then the cursor is moved to the first
  3009.     non-blank column of the next line. If the next line is also blank,
  3010.     the cursor column does not change.
  3011.  
  3012.     The AutoIndent setting can affect the following commands when a new
  3013.     line is inserted:
  3014.  
  3015.     - lins      "Insert Line"  <Ctrl-Enter>
  3016.     - lspl      "Split Line"   <Alt-S>
  3017.     - enteredit                <Enter>
  3018.     - entering characters when "Word Wrap" is ON
  3019.  
  3020.   - wmvtab  "Variable Tabs"
  3021.  
  3022.     This setting allows you use the preset tab positions specified in
  3023.     the "Tabs" configuration setting (see "Configuration - Word
  3024.     Processing" 17-4).
  3025.  
  3026.     If this setting is ON, and the "ctab" <Tab> command is entered, the
  3027.     cursor will move to the next column position specified in the "Tabs"
  3028.     configuration setting. Entering the "ctab %l" <Shift-Tab> command
  3029.     will do the same in reverse.
  3030.  
  3031.     If set ON, Variable Tabs will override regular "Interval" Tabs, but
  3032.     Variable Tabs can in turn be overridden by "Smart Tabs" (see below).
  3033.  
  3034.   - wmsmtab  "Smart Tabs"
  3035.  
  3036.     Setting Smart Tabs ON can save you time when entering data in
  3037.     columns.
  3038.  
  3039.     If this setting is ON, and the "ctab" <Tab> command is entered, the
  3040.     cursor will move to the column of the next word on the nearest
  3041.     previous non-blank line. Entering the "ctab %l" <Shift-Tab> command
  3042.     will do the same in reverse.
  3043.  
  3044.     If set ON, "Smart Tabs" will override Variable Tabs and Interval
  3045.     Tabs.
  3046.                                                     Window Settings   54
  3047.  
  3048.  
  3049.   - wmmat  "Match Character"
  3050.  
  3051.     This setting can be useful for entering expressions in program
  3052.     source code. If this setting is ON and the characters (, [, or " are
  3053.     entered, The Aurora Editor will automatically enter the matching
  3054.     character ), ], or ".
  3055.  
  3056.   - wmbak  "Backup"
  3057.  
  3058.     If this setting ON and the current file is saved with The Aurora
  3059.     Editor, the previous version of the file on disk will be saved in
  3060.     a backup file. The new backup file will replace any existing backup
  3061.     file.
  3062.  
  3063.     If a backup directory is defined with the configuration setting
  3064.     "BakDir" (see "Configuration - Save Options" 17-7), then the backup
  3065.     file will be saved in the specified backup directory, otherwise it
  3066.     will be saved with the extension defined with the "BakExt"
  3067.     configuration setting (the default is ".BAK") in the same directory
  3068.     as the file.
  3069.  
  3070.   - wmdraw  "Line Draw"  <Ctrl-D>
  3071.  
  3072.     This setting can be useful for creating boxes, charts, and other
  3073.     text mode drawings. When Line Draw is ON, the cursor keys can be
  3074.     used to draw lines using the text mode graphics characters.
  3075.  
  3076.   - sdraws [0/1/2/3/4]  "Line Style"
  3077.  
  3078.     This setting is the line style used to draw lines with the cursor
  3079.     keys when Line Draw is ON. You can choose any of the following
  3080.     values:
  3081.  
  3082.       0 - Single
  3083.       1 - Double Horizontal
  3084.       2 - Double Vertical
  3085.       3 - Double
  3086.       4 - Eraser
  3087.  
  3088.   - wmtran  "Translate"  <Alt-F4>
  3089.  
  3090.     This setting allows you to expand abbreviations and correct commonly
  3091.     misspelled words or typos as you enter characters into the text of
  3092.     an Edit window. You can also define macros that are executed
  3093.     whenever the name of the macro is entered as a word in your text.
  3094.  
  3095.     When Text Translation is ON, the editor will automatically check
  3096.     each "word" you type to see if it exists in a special user-defined
  3097.     translation lookup table in the file ATRN.A. If the word is found,
  3098.     it will be replaced with the substitution text that you have defined
  3099.     in the table (see "Text Translation" 18-7).
  3100.  
  3101.                                                     Global Settings   55
  3102.  
  3103.  
  3104.   13-2  Global Settings
  3105.   ─────────────────────
  3106.  
  3107.   There are many settings which are global to all windows. These
  3108.   settings are macro language variables located in the configuration
  3109.   file ACFG.A, and can be modified as configuration settings (see
  3110.   "Configuration" 17-1).
  3111.  
  3112.   However, some of these global settings can also be modified during an
  3113.   edit session from the "Set" pull-down menu. If you wish, you can also
  3114.   define keys which display the current values of these settings and
  3115.   prompt you to enter new values.
  3116.  
  3117.   The following section describes global settings which can be changed
  3118.   during an edit session from the "Set" pull-down menu. Each setting is
  3119.   listed in the following format:
  3120.  
  3121.     promptcommand  "menu item"  <key>
  3122.  
  3123.   The "promptcommand" is the command which displays the current value of
  3124.   the setting and prompts you to enter a new value. The "menu item" is
  3125.   the description of the setting as it appears on the "Set" pull-down
  3126.   menu. <key> is the default key used to display the prompt (if any):
  3127.  
  3128.   - asktabw  "Tab Width.."
  3129.  
  3130.     The Tab Width specifies the distance between tab stops for "Interval
  3131.     Tabs". For example, a value of 8 would place tab stops at columns 1,
  3132.     9, 17, 25, etc. The cursor can be moved to the tab stops by using the
  3133.     "ctab" <Tab> and "ctab %l" <Shift-Tab> commands when the "Variable
  3134.     Tabs" and "Smart Tabs" settings are OFF.
  3135.  
  3136.     The "TabWidth" setting is also used as the tab width for the
  3137.     "exptab" <Ctrl-K-X> command ("Expand Tabs" on the "Edit" pull-down
  3138.     menu).
  3139.  
  3140.     The default value of the Tab Width is determined by the
  3141.     configuration setting "TabWidth". The installation default is 8.
  3142.  
  3143.   - asktabv  "Variable Tab Stops.."
  3144.  
  3145.     This setting is a string of explicitly specified tab stops which you
  3146.     can use to override the Interval Tabs specified by the "TabWith"
  3147.     setting above, when the "Variable Tabs" setting is ON (and the
  3148.     "Smart Tabs" setting is OFF). Unlike the tab stops specified with
  3149.     the "Tab Width" setting, Variable Tab Stops need not occur at
  3150.     regular intervals.
  3151.                                                     Global Settings   56
  3152.  
  3153.  
  3154.     The default value of "Variable Tab Stops" is determined by the
  3155.     configuration setting "Tabs". The installation default is "4 8 16 24
  3156.     50 72".
  3157.  
  3158.   - asklmrg  "Left Margin.."
  3159.  
  3160.     The Left Margin setting is used as the default left margin for the
  3161.     following commands on the "Block" pull-down menus, when used with
  3162.     line marks:
  3163.  
  3164.     - lcen      "Center Line"
  3165.     - mjust     "Left Justify", "Right Justify", "Center"
  3166.     - askmfill  "Fill"
  3167.     - mmov %of  "Move Over"
  3168.     - mrfl      "Reflow", "Reflow RJust"
  3169.  
  3170.     The default value of the Left Margin is determined by the
  3171.     configuration setting "LMargin". The installation default is 3.
  3172.  
  3173.   - askrmrg  "Right Margin.."
  3174.  
  3175.     The Right Margin setting is used as the right margin for the "Word
  3176.     Wrap" Window Setting, and for the same block commands used with line
  3177.     marks described above in the Left Margin setting (see above).
  3178.  
  3179.     The default value of the Right Margin is determined by the
  3180.     configuration setting "RMargin". The installation default is 72.
  3181.  
  3182.   - askind  "Paragraph Indent.."
  3183.  
  3184.     This setting determines the number of columns to indent a paragraph
  3185.     when using the "mrfl %b" commands ("Reflow" and "Reflow RJust" on
  3186.     the "Block" pull-down menu).
  3187.  
  3188.     The default value of Paragraph Indent is determined by the
  3189.     configuration setting "Indent". The installation default is 0.
  3190.  
  3191.   - askdefx  "Default File Extensions.."
  3192.  
  3193.     This setting is a list of default file extensions to try when you
  3194.     attempt to open a file without specifying a file extension.
  3195.  
  3196.     The default value of "Default File Extensions" is determined by the
  3197.     configuration setting "DefExt" (see "Configuration - Default File
  3198.     Extensions 17-5). The installation default is "c h cpp doc txt a asm
  3199.     pas inc bat".
  3200.                                                     Global Settings   57
  3201.  
  3202.  
  3203.   - askbin  "Binary Line Length.."
  3204.  
  3205.     This setting is used to determine the length of each line in the
  3206.     file when the file is loaded in Binary Mode.
  3207.  
  3208.     The default value of the Binary Line Length is determined by the
  3209.     configuration setting "BinaryLength". The installation default is
  3210.     64.
  3211.  
  3212.   - askdlm  "Line Delimiter.."
  3213.  
  3214.     This setting is the end-of-line delimiter to be used when loading
  3215.     and saving files in non-binary mode. The Line Delimiter can be one
  3216.     or two bytes long. If the line delimiter is two bytes long, only the
  3217.     last byte is actually used as the line delimiter during file loading
  3218.     (however, if the first byte is found immediately before the second
  3219.     byte, it will be "blanked-out" along with the second byte during the
  3220.     loading process).
  3221.  
  3222.     The default value of the Line Delimiter is determined by the
  3223.     configuration setting "LineDlm". The installation default is "0D0Ah"
  3224.     (carriage return & linefeed).
  3225.  
  3226.  
  3227.   You can save and restore all the current global settings with the
  3228.   following commands:
  3229.  
  3230.   - setres   "Restore Settings"  <Alt-F2>
  3231.  
  3232.     Use the "setres" <Alt-F2> command whenever you wish to restore the
  3233.     default settings, or when you need to change the files containing
  3234.     the configuration settings (ACFG.A), keyboard and mouse definitions
  3235.     (AKBD.A), menu and tool bar definitions (AMEN.A), or text
  3236.     translation definitions (ATRN.A).
  3237.  
  3238.     This command actually re-compiles the macro language source file
  3239.     A.A, and re-generates the file A.X. The source file A.A includes the
  3240.     files ACFG.A, AMEN.A, ALIB.X, AKBD.A, and ATRN.A. The resulting
  3241.     compiled file A.X is interpreted by A.EXE and A3.EXE and contains
  3242.     all the compiled macro language code for The Aurora Editor.
  3243.  
  3244.     Note that if you have previously used the "setsav" command (see
  3245.     below) to save global settings, those settings will revert back to
  3246.     the defaults defined in ACFG.A after this command is entered.
  3247.                                                     Global Settings   58
  3248.  
  3249.  
  3250.   - setsav   "Save Current Settings"
  3251.  
  3252.     This command saves all the current settings, including the settings
  3253.     described above, printer settings, the current window style, prompt
  3254.     style, and the current video mode.
  3255.  
  3256.     Note: This command works the same as the setres <Alt-F2> command
  3257.     (see above), except that configuration settings are taken from the
  3258.     current edit session. The file ACFG.A is not included.
  3259.                                                          Key Macros   59
  3260.  
  3261.  
  3262.   14-1  Key Macros
  3263.   ────────────────
  3264.  
  3265.   A Key Macro is a "recorded" sequence of keystrokes which can be played
  3266.   back on demand. This feature can be very useful for situations where
  3267.   the same sequence of keystrokes are entered over and over again.
  3268.  
  3269.   The Aurora Editor will allow you to record and play key macros of
  3270.   virtually any length. Once they are recorded, you can assign them to a
  3271.   key of your choice, or just keep them in a temporary "scrap" area. You
  3272.   can save and load key macros that you have previously recorded. Also,
  3273.   The Aurora Editor can be configured to automatically load and save all
  3274.   your key macros when you enter and exit the editor (see the "SaveMac"
  3275.   configuration setting 17-11).
  3276.  
  3277.   The key macro commands are:
  3278.  
  3279.   - krec  "Record Toggle"  <Ctrl-R>
  3280.  
  3281.     This command will toggle the record mode ON and OFF. When the record
  3282.     mode is ON, all keystrokes you enter will be recorded until the
  3283.     record mode is turned OFF. After a key macro has been recorded, it
  3284.     resides in a temporary "scrap" buffer until it is assigned to a key
  3285.     or erased.
  3286.  
  3287.     If the record mode is turned ON and there is already a key macro in
  3288.     the scrap buffer, any new recorded keystrokes will be appended to
  3289.     the end of the macro in the scrap buffer. To record a completely new
  3290.     key macro, you should first delete any key macro in the scrap buffer
  3291.     with the "kdel" <Ctrl-I> command (see below).
  3292.  
  3293.   - kplay  "Play"  <Ctrl-E>
  3294.  
  3295.     This command will "play" the key macro in the scrap buffer.
  3296.  
  3297.   - kdel  "Erase"  <Ctrl-I>
  3298.  
  3299.     This command will erase the key macro in the scrap buffer.
  3300.  
  3301.   - kdel %a  "Erase All"
  3302.  
  3303.     This command will erase ALL current key macros. This includes any
  3304.     key macros that were assigned to keys and the key macro in the
  3305.     scrap buffer.
  3306.                                                          Key Macros   60
  3307.  
  3308.  
  3309.   - askkopen  "Open.."
  3310.  
  3311.     This command will prompt you for a key macro file created by the
  3312.     "askksav" command, and then load the key macro file. If there are
  3313.     any conflicts between key assignments in the macro file and current
  3314.     key macro assignments, the key macros in the file will replace the
  3315.     current key macros.
  3316.  
  3317.     Prompt history is available at this prompt (see "Prompts" 2-6).
  3318.  
  3319.   - kopen [filename]
  3320.  
  3321.     This command opens the key macros in the specified filename, without
  3322.     prompting you for the filename.
  3323.  
  3324.   - askksav  "Save.."
  3325.  
  3326.     This command will prompt you for a filename, and then saves all the
  3327.     current key macros in the filename you entered. All macros will be
  3328.     saved, including any key macros that were assigned to keys and the
  3329.     key macro in the scrap buffer.
  3330.  
  3331.     Prompt history is available at this prompt (see "Prompts" 2-6).
  3332.  
  3333.   - ksav  [filename]
  3334.  
  3335.     This command saves all the current key macros in the specified
  3336.     filename, without prompting.
  3337.  
  3338.   - kcat  "Assign to Key.."
  3339.  
  3340.     This command allows you to assign the key macro in the "scrap"
  3341.     buffer to the function key of your choice. You will be prompted to
  3342.     enter the function key. Note that you cannot assign a key macro to a
  3343.     "compound" function key, such as "<F1> <F2>".
  3344.  
  3345.     When the key macro in the scrap buffer has been assigned to a
  3346.     function key, it is removed from the scrap buffer.
  3347.                                                     Other Commands   61
  3348.  
  3349.  
  3350.   15-1  Other Commands
  3351.   ────────────────────
  3352.  
  3353.   Other macro commands are available from the "Macro" pull-down menu:
  3354.  
  3355.   - opena %acfg  "Configuration.."
  3356.  
  3357.     This command opens the file ACFG.A which contains all the
  3358.     configuration settings for The Aurora Editor.
  3359.  
  3360.   - opena %akbd  "Keys.."
  3361.  
  3362.     This command opens the file AKBD.A which contains the current
  3363.     keyboard and mouse definitions for The Aurora Editor.
  3364.  
  3365.   - opena %amen  "Menus.."
  3366.  
  3367.     This command opens the file AMEN.A which contains the current menu
  3368.     and tool bar definitions for The Aurora Editor.
  3369.  
  3370.   - opena %atrn  <Alt-F5>
  3371.  
  3372.     This command opens the file ATRN.A which contains the current text
  3373.     translation table definitions for The Aurora Editor.
  3374.  
  3375.   - askmcmd  "Macro Command.."  <Ctrl-V>
  3376.  
  3377.     This command prompts you for a macro language expression, and then
  3378.     evaluates it. For complete documentation on The Aurora Macro
  3379.     Language, see "The Aurora Macro Language Guide" (AML.DOC).
  3380.  
  3381.     Prompt history is available at this prompt (see "Prompts" 2-6).
  3382.  
  3383.   - askmrun  "Run Macro.."
  3384.  
  3385.     This command prompts you for the name of a macro language file, and
  3386.     then executes it. The macro language file may be a source file
  3387.     (extension ".A"), or a compiled file (extension ".X"). If no file
  3388.     extension is specified, then ".X" is tried first, followed by ".A".
  3389.     When the macro file is finished executing, all the macro code loaded
  3390.     from the file is discarded.
  3391.  
  3392.     Prompt history is available at this prompt (see "Prompts" 2-6).
  3393.  
  3394.   - askminc  "Include Macro.."
  3395.  
  3396.     This command is identical to the "askmrun" command above, except
  3397.     that when the macro file is finished executing, all the loaded macro
  3398.     code remains present in the editor.
  3399.  
  3400.     Prompt history is available at this prompt (see "Prompts" 2-6).
  3401.                                                     Other Commands   62
  3402.  
  3403.  
  3404.   - askmcom  "Compile Macro.."
  3405.  
  3406.     This command prompts you for the name of a macro language source
  3407.     file, and then compiles it. If no file extension is specified, then
  3408.     ".A" is assumed. The compiled file is placed in the same directory
  3409.     as the source file, but has the extension ".X".
  3410.  
  3411.     Prompt history is available at this prompt (see "Prompts" 2-6).
  3412.  
  3413.  
  3414.   Other macro commands not available from the "Macro" pull-down are:
  3415.  
  3416.   - mcmd  [macro expression]
  3417.  
  3418.     This command evaluates the specified macro expression, without
  3419.     prompting.
  3420.  
  3421.   - mrun  [macro source or compiled filename]
  3422.  
  3423.     This command evaluates the specified macro source or compiled file,
  3424.     without prompting. When done, the macros are discarded.
  3425.  
  3426.   - minc  [macro source or compiled filename]
  3427.  
  3428.     This command evaluates the specified macro source or compiled file,
  3429.     without prompting. When done, the macro code remains in the editor.
  3430.  
  3431.   - mcom  [macro source filename]
  3432.  
  3433.     This command compiles the specified macro source file, without
  3434.     prompting you for the filename.
  3435.  
  3436.  
  3437.   15-2  Miscellaneous Library Functions
  3438.   ─────────────────────────────────────
  3439.  
  3440.   The following commands are some additional library functions contained
  3441.   in ALIB.X for use with The Aurora Macro Language (see "The Aurora
  3442.   Macro Language Guide").
  3443.  
  3444.   - say  [message]  [options].
  3445.  
  3446.     Displays the string [message] on the window title bar. The following
  3447.     options may be specified:
  3448.  
  3449.       b - a short beep is sounded
  3450.       k - the user is prompted to enter a character. The character
  3451.           entered is returned.
  3452.                                                     Other Commands   63
  3453.  
  3454.  
  3455.   - mbox  [title]  [message]  [options].
  3456.  
  3457.     Displays the message [message] in a dialog box with an "Ok" button.
  3458.     The dialog box will have the window title [title]. If the option
  3459.     "b" is specified, a short beep is sounded.
  3460.  
  3461.   - ask  [prompt]  [title]  [width].
  3462.  
  3463.     Prompts the user for a string using the prompt description [prompt].
  3464.     This function returns the string entered at the prompt, or null if
  3465.     the prompt was cancelled.
  3466.  
  3467.     If user-defined prompts are configured to appear as dialog boxes
  3468.     (see "Configuration - Editing Preferences" 17-8), then [title] and
  3469.     [width] specify the dialog box title and width. If the width is not
  3470.     specified, the default width is 44.
  3471.  
  3472.   - askbox  [title]  [options]  [item 1]  [item 2]  [item 3] ...
  3473.  
  3474.     Displays a menu box with the title [title]. One of the following
  3475.     [options] can be specified:
  3476.  
  3477.       o - displays an "Ok/Cancel" menu box
  3478.       y - displays a "Yes/No/Cancel" menu box
  3479.       i - displays a menu box with the lines [item 1], [item 2], etc.
  3480.           To highlight a character in a menu item, prefix it with an
  3481.           ampersand (&) character.
  3482.  
  3483.     If no options are specified, the default is "i".
  3484.  
  3485.     This function returns the menu item selected (without the first
  3486.     character - the first character is usually blank), or null if the
  3487.     menu box was cancelled by pressing <Esc> or clicking on the menu box
  3488.     "close" (≡) icon.
  3489.  
  3490.   - keyx  [key prefix].
  3491.  
  3492.     Creates a new compound key prefix. Compound key prefixes can greatly
  3493.     increase the number of available function keys (see "Defining
  3494.     Compound Keys" 18-3).
  3495.  
  3496.   - askkrep  <Ctrl-Q-Q>
  3497.  
  3498.     Repeats the last key command entered. The user is prompted for the
  3499.     number of repetitions.
  3500.  
  3501.   - moubegmrk  [x]  [y]  [options].
  3502.  
  3503.     This command allows you to create a marked block from within a mouse
  3504.     event handler function. [x] and [y] are virtual x and y coordinates
  3505.     which specify the starting point of the marked block on the screen
  3506.     ([x] and [y] are passed to the mouse event handler function by the
  3507.     editor).
  3508.                                                     Other Commands   64
  3509.  
  3510.  
  3511.     [options] specifies the type of mark to be created and can be one of
  3512.     the following:
  3513.  
  3514.       l - line mark
  3515.       r - column mark
  3516.       s - stream mark
  3517.  
  3518.   - moumovmrk  [x]  [y].
  3519.  
  3520.     This command extends the marked block created with the "moubegmrk"
  3521.     command above to virtual coordinates [x] and [y]  ([x] and [y] are
  3522.     passed to the mouse event handler by the editor).
  3523.  
  3524.   - mouendmrk  [x]  [y].
  3525.  
  3526.     This command extends the marked block created with the "moubegmrk"
  3527.     command above to virtual coordinates [x] and [y], and completes the
  3528.     mouse marking process ([x] and [y] are passed to the mouse event
  3529.     handler by the editor).
  3530.  
  3531.   - dn.
  3532.  
  3533.     Returns the filename or directory name at the cursor in a File
  3534.     Manager window.
  3535.  
  3536.   - winsizt  [left]  [top]  [right]  [bottom]  [reps]  [options].
  3537.  
  3538.     Resizes the current window to coordinates [left], [top], [right],
  3539.     [bottom]. Unlike the native function "winsiz", this function adjusts
  3540.     the title bar controls (see "The Aurora Macro Language Guide"). The
  3541.     following [options] may be specified:
  3542.  
  3543.       r - coordinates are relative to the current size
  3544.       a - coordinates are absolute (relative the "origin" - see below)
  3545.       s - scrolls the window to keep the cursor visible, if necessary
  3546.  
  3547.     If option "a" is specified, the following options may also be
  3548.     specified:
  3549.  
  3550.       d - origin is at the top left corner of the screen
  3551.       z - origin is at the virtual coordinates 0, 0
  3552.  
  3553.     If option "r" is specified, [reps] specifies the number of sizing
  3554.     repetitions (the default is 1). If no options are specified, option
  3555.     "r" is assumed.
  3556.  
  3557.                                                     Other Commands   65
  3558.  
  3559.   - qwrd  [char set].
  3560.  
  3561.     Returns the word at the cursor. [char set] is the character set used
  3562.     to define a word (see "Configuration - Character Sets" 17-14).
  3563.  
  3564.   - qwinmin.
  3565.  
  3566.     Returns "1" if the current window is minimized, otherwise it returns
  3567.     null.
  3568.  
  3569.   - qwinmax.
  3570.  
  3571.     Returns "1" if the current window is maximized, otherwise it returns
  3572.     null.
  3573.  
  3574.   - qtimdat
  3575.  
  3576.     Returns a string consisting of the current date and time, in the
  3577.     following format: MM/DD/YY HH:MMmm. For example, "08/30/93
  3578.     01:01am".
  3579.                                                    The File Manager   66
  3580.  
  3581.  
  3582.   16-1  The File Manager
  3583.   ──────────────────────
  3584.  
  3585.   The File Manager is a very useful feature of The Aurora Editor. You
  3586.   can use it to display a list of files in a directory and select one
  3587.   for editing. You can also use it to select several files from a
  3588.   directory and perform file management functions with the selected
  3589.   files, such as Copy, Print, Run, and others - all without leaving the
  3590.   editor.
  3591.  
  3592.   Any number of File Manager windows can be open at one time. Each File
  3593.   Manager window is independent of any other windows. For example, you
  3594.   could have one File Manager window showing a directory on drive C and
  3595.   another File Manager window showing a different directory on drive D.
  3596.  
  3597.   File Manager windows look and behave much like Edit windows in many
  3598.   respects. They are similar in appearance to Edit windows except that
  3599.   they display a directory listing instead of file text. They also have
  3600.   a drive menu bar immediately below the main menu bar, where you can
  3601.   select disk drives (network disk drives are highlighted). Note that
  3602.   File Manager window borders, title bars, title bar controls, menus,
  3603.   and scroll bars all work the same as they do for Edit windows.
  3604.  
  3605.   The following is an example of a File Manager window:
  3606.  
  3607.  
  3608.     Close Icon       North Title Bar
  3609.        │                   │
  3610.        │    North Title    │      Menu Bar        Min/Max/Restore Icons
  3611.        │        │          │        │                       │
  3612.     ▒▒▒│▒▒░░░░░░│░░░░░░░░░░│░░░░░░░░│░░░░░░░░░░░░░░░░░░░░░░░│▒▒▒▒▒
  3613.     ▒▒ ≡ C:\DOC\*.*        ┴        │                      └  ▒▒
  3614.     ▒▒ File  Window  Mark  Command  Sort  Print  Macro  Help    ▒▒
  3615.     ░░ <>  <A>  <B>  <C>  <D>  <E>                             ░░
  3616.     ░░ ..\                                                     ░░
  3617.     ░░ SUBDIR2\                   92-11-02  11:54:06pm  A      ▒───┐
  3618.     ░░ DEMO1    .BAK       31092  93-03-01   4:11:14am  A      ■░░ │
  3619.     ░░ DEMO1    .C         31317  93-03-01   4:15:10am  A      ▒░░ │
  3620.     ░░ HELLO    .TXT        2030  93-01-25   7:33:54pm  A      ░░ │
  3621.     ▒▒■▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  3622.     ▒▒ 2,114,732 bytes in 114 files    ┬    │   ┌─ Aurora v1.20 ▒▒ │
  3623.     ▒▒▒▒▒▒░░░░│░░░░░░░░░░░░░░░░░░░░░░░░│░░░░│░░░│░░░░░░░░░░░▒▒▒▒▒▒ │
  3624.       │       │        │               │    │   │                  │
  3625.     Corner    │        │  South Title Bar   │  South Title         │
  3626.               │        │                    │                      │
  3627.        South Title    Border          Horz Scroll Bar     Vert Scroll Bar
  3628.                                                    The File Manager   67
  3629.  
  3630.  
  3631.   For each file, the File Manager displays:
  3632.  
  3633.     - the filename and extension
  3634.     - the file size (in bytes or k)
  3635.     - the date and time the file was last modified (or created)
  3636.     - the file attributes (A=archive, H=hidden, R=readonly, S=system)
  3637.  
  3638.   The "south title" of the File Manager window also displays the total
  3639.   number of files in the listing, and the total size (in bytes or k) of
  3640.   all the files.
  3641.  
  3642.  
  3643.   16-2  Creating a File Manager Window
  3644.   ────────────────────────────────────
  3645.  
  3646.   There are several ways to create a new File Manager window:
  3647.  
  3648.   - After entering "A" or "A3" on the DOS command line, enter the
  3649.     name of a directory or a filename with "wildcard" characters (*, ?).
  3650.  
  3651.     Examples:
  3652.       a *.*  <Enter>          - displays a listing of the current directory
  3653.       a .  <Enter>            - displays a listing of the current directory
  3654.       a c:\sys  <Enter>       - displays a listing of the "c:\sys" directory
  3655.       a c:\sys\a*.*  <Enter>  - displays a listing of the "c:\sys" directory
  3656.                                  of all filenames beginning with 'a'
  3657.       a hello.txt .  <Enter>  - creates an Edit window for "hello.txt"
  3658.                                  and a File Manager window listing the
  3659.                                  current directory
  3660.  
  3661.   - Enter the "askopen" <Alt-E> command ("Open.." from the "File" menu)
  3662.     to bring up the Open prompt, and then enter the name of a directory,
  3663.     or a filename with "wildcard" characters (see previous examples). If
  3664.     you press <Enter> from the Open prompt without entering a name, The
  3665.     Aurora Editor will create a File Manager window for the current
  3666.     directory.
  3667.  
  3668.   - Enter the "fmgr" <F4> command ("File Manager.." from the "File"
  3669.     menu) in the current Edit window to create a File Manager window for
  3670.     the current directory.
  3671.  
  3672.   - From an Edit window, position the mouse on the title bar and press
  3673.     the right mouse button to create a File Manager window for the
  3674.     current directory.
  3675.                                                    The File Manager   68
  3676.  
  3677.  
  3678.   16-3  Changing the Directory Listing in a File Manager Window
  3679.   ─────────────────────────────────────────────────────────────
  3680.  
  3681.   It is not always necessary to create a new File Manager window for
  3682.   each directory you wish to display. You can use a single File Manager
  3683.   window to display any drive or directory on your computer.
  3684.  
  3685.   To change the drive displayed in a File Manager window using the
  3686.   mouse, click the left mouse button on the desired drive letter on the
  3687.   drive menu. Using the keyboard, press the <Tab> key repeatedly until
  3688.   the desired drive letter is highlighted and then press <Enter>, or
  3689.   press the <Tab> key and then enter the drive letter.
  3690.  
  3691.   To change the directory displayed in the File Manager window, position
  3692.   the cursor to the desired directory and press <Enter>. To display the
  3693.   directory using the mouse, position the mouse cursor to the directory
  3694.   and double-click the left mouse button.
  3695.  
  3696.   To display the parent directory using the keyboard:
  3697.  
  3698.   - enter the "fpar" <Ctrl-Backspace> command, or:
  3699.   - position the cursor to the "..\" directory and press <Enter>, or:
  3700.   - use the <Tab> key to select the "" icon on the drive menu and
  3701.     then press <Enter>
  3702.  
  3703.   To display the parent directory using the mouse:
  3704.  
  3705.   - click the left mouse button on the "" icon on the drive menu, or
  3706.   - double-click the left mouse button on the "..\" directory
  3707.  
  3708.  
  3709.   16-4  File Manager Commands
  3710.   ───────────────────────────
  3711.  
  3712.   The Aurora Editor allows many commands such as Open, Move, Copy, etc,
  3713.   to performed on files displayed in a File Manager window. You can
  3714.   execute these commands by selecting them from the File Manager
  3715.   "Command" pulldown menu, or by positioning the cursor next to the file
  3716.   or directory and typing in the one-character "command code" for the
  3717.   command you wish to enter. The "command code" is just the highlighted
  3718.   character for the command on the "Command" pulldown menu. If you have
  3719.   previously "marked" any files (see "Marking Files in the File Manager
  3720.   16-5" below), then the command you selected will be performed on all
  3721.   the marked files in the File Manager window.
  3722.  
  3723.   The following section lists the File Manager commands. The one
  3724.   character "command codes" are shown in angled brackets:
  3725.                                                    The File Manager   69
  3726.  
  3727.  
  3728.   - fopen  "Open"  <e>, <o>, <z>, <Enter>, <Ctrl-Enter>
  3729.  
  3730.     This command opens the file and displays it in an Edit window. You
  3731.     can also open the file by double clicking the left mouse button over
  3732.     the file. If you open the file by entering the "z" command code, the
  3733.     new Edit window will be maximized.
  3734.  
  3735.     Note that the <Enter> key will only open the file at the cursor,
  3736.     even if multiple files are marked (see "Marking Files in the File
  3737.     Manager" 16-5). This can be useful for viewing files while marking
  3738.     them.
  3739.  
  3740.     Pressing <Ctrl-Enter> will open the file AND close the File Manager
  3741.     window. The Aurora Editor can be configured so that the File Manager
  3742.     window is always closed whenever a file is opened from it (see the
  3743.     "FmgrQuit" setting in "Configuration - Open Options" 17-6).
  3744.  
  3745.     If the left or right <Shift> key is pressed down when a file is
  3746.     opened from the File Manager, the new Edit window will be tiled
  3747.     (vertically) with all existing windows.
  3748.  
  3749.     If multiple files are marked for opening, the "e" and "z" command
  3750.     codes will load them all into one window. The "o" command code will
  3751.     load each file into a separate window.
  3752.  
  3753.   - fopen %b  "Open Binary"  <b>, <y>
  3754.  
  3755.     This command opens the file in binary mode. The "Binary Line Length"
  3756.     setting is used as the line length (see "Global Settings" 13-2). The
  3757.     <y> command code will load all marked files into only one window,
  3758.     whereas <b> will create a separate window for each file.
  3759.  
  3760.   - fopenk  "Open Key Macro"  <k>
  3761.  
  3762.     This command opens a key macro file. The file must be a valid key
  3763.     macro file. If any conflict exists between old and new key macro
  3764.     assignments, the new key assignments will replace the old key
  3765.     assignments.
  3766.  
  3767.   - fmov  "Move.."  <m>
  3768.  
  3769.     This command moves the file to another filename, directory, or
  3770.     drive. You will be prompted for the new name. You can specify a
  3771.     fully qualified filename, or just a drive or directory.
  3772.     Directories cannot be moved in version 1.20.
  3773.  
  3774.   - fcpy  "Copy.."  <c>
  3775.  
  3776.     This command copies the file to another filename, directory, or
  3777.     drive. You will be prompted for the new name. You can specify a
  3778.     fully qualified filename, or just a drive or directory.
  3779.     Directories cannot be copied in version 1.20.
  3780.                                                    The File Manager   70
  3781.  
  3782.  
  3783.   - fdel  "Delete"  <d>, <Del>
  3784.  
  3785.     This command deletes the file. The Aurora Editor can be configured
  3786.     to delete files with or without user confirmation (see the "ConDel"
  3787.     setting in "Configuration - Confirmations" 17-16). Empty Directories
  3788.     can also be deleted. Directories containing files or other
  3789.     directories cannot be deleted in version 1.20.
  3790.  
  3791.   - fren  "Rename.."  <n>
  3792.  
  3793.     This command changes the name of the file. You will be prompted for
  3794.     the new name. This command can also be used to change directory
  3795.     names.
  3796.  
  3797.     Note: the "Rename" command will ignore any marked files and only
  3798.     works on the file or directory at the cursor (see "Marking Files in
  3799.     the File Manager" 16-5).
  3800.  
  3801.   - frun %c  "Run"  <r>
  3802.  
  3803.     This command executes the file. The file must have a .COM, .EXE,
  3804.     or .BAT extension.
  3805.  
  3806.   - fprt  "Print"  <p>
  3807.  
  3808.     This command prints the file using the current printer settings (see
  3809.     "Configuration - Print Settings" 17-10). The contents of a directory
  3810.     can also be printed with this command.
  3811.  
  3812.   - fatt  "Attributes.."  <a>
  3813.  
  3814.     This command prompts you to change the attributes of a file.
  3815.     Directory attributes can also be changed.
  3816.  
  3817.   - ftch  "Touch"  <t>
  3818.  
  3819.     This command changes the file's date and time to the current date
  3820.     and time. Directories cannot be "touched".
  3821.  
  3822.  
  3823.   Other functions available on the File Manager "Command" menu are:
  3824.  
  3825.   - fcred  "Create Directory.."
  3826.  
  3827.     This command prompts you for a directory name and creates a new
  3828.     directory.
  3829.                                                    The File Manager   71
  3830.  
  3831.  
  3832.   - askscan  "Scan.."  <Ctrl-S>
  3833.  
  3834.     This command allows you to scan a directory or a "wildcard" file
  3835.     specification for a character string (see "Search and Replace"
  3836.     11-1).
  3837.  
  3838.  
  3839.   16-5  Marking Files in the File Manager
  3840.   ───────────────────────────────────────
  3841.  
  3842.   Marking files is a convenient way to execute a single File Manager
  3843.   command on many files in a File Manager window. For example, you can
  3844.   mark a number of files and then copy them all to another directory
  3845.   with only one copy command, instead of copying each file individually.
  3846.  
  3847.   To execute a File Manager command on marked files, simply mark the
  3848.   files with any of the commands listed below and then enter the desired
  3849.   command. The File Manager will automatically detect the presence of
  3850.   marked files and execute the command on the marked files instead of
  3851.   the file at the cursor. Marked files are indicated by a "" character
  3852.   to the left of the filename.
  3853.  
  3854.   You can use the following commands to mark and unmark files:
  3855.  
  3856.   - fmtog  "Mark Toggle"  <Space Bar>
  3857.  
  3858.     This command will toggle the current "marked state" of the file or
  3859.     directory at the cursor. If the file is already marked, it will be
  3860.     unmarked, otherwise it will be marked.
  3861.  
  3862.     Holding the <Shift> key down while using the <cursorup> and
  3863.     <cursordown> keys will also toggle the marked state of the file or
  3864.     directory at the cursor. This can be useful for marking or unmarking
  3865.     a series of contiguous files or directories.
  3866.  
  3867.   - using the mouse
  3868.  
  3869.     Hold the <Shift> key down while clicking the left mouse button over
  3870.     the file or directory at the cursor. This will toggle the marked
  3871.     state of the file or directory. With the left mouse button and
  3872.     <Shift> keys still pressed down, drag the mouse to toggle the marked
  3873.     state of series of contiguous files or directories.
  3874.  
  3875.   - fmrk  "Mark All"  <Alt-M>
  3876.  
  3877.     This command will mark all the files in the current File Manager
  3878.     window. Directories will not be marked.
  3879.                                                    The File Manager   72
  3880.  
  3881.  
  3882.   - fumrk  "Unmark All"  <Alt-U>
  3883.  
  3884.     This command will unmark any marked files and directories in the
  3885.     current File Manager window.
  3886.  
  3887.  
  3888.   16-6  File Manager Sorting
  3889.   ──────────────────────────
  3890.  
  3891.   The order of the files listed in the File Manager can be changed by
  3892.   selecting the desired sort order from the File Manager "Sort"
  3893.   pull-down menu. The configuration setting "FmgrSrt" determines the
  3894.   default sort order when a File Manager window is created (see
  3895.   "Configuration - Open Options" 17-6).
  3896.  
  3897.   You can sort File Manager windows by entering the "fsrt" command with
  3898.   the appropriate parameter:
  3899.  
  3900.   - fsrt %n  "Name"  <Alt-N>
  3901.  
  3902.     This command sorts the File Manager window by filename.
  3903.  
  3904.   - fsrt %s  "Size"  <Alt-S>
  3905.  
  3906.     This command sorts the File Manager window by file size in
  3907.     descending order.
  3908.  
  3909.   - fsrt %d  "Date-Time"  <Alt-D>
  3910.  
  3911.     This command sorts the File Manager window by file date and time in
  3912.     descending order.
  3913.  
  3914.   - fsrt %o  "OS Default"  <Alt-O>
  3915.  
  3916.     This command lists the File Manager window contents in the DOS
  3917.     default order.
  3918.                                                       Configuration   73
  3919.  
  3920.  
  3921.   17-1  Configuration
  3922.   ───────────────────
  3923.  
  3924.   The Aurora Editor is a highly configurable editor. There are
  3925.   configuration settings for video, mouse, window appearances, editing
  3926.   preferences, printing, desktop, and much more.
  3927.  
  3928.   Configuration settings are stored in the file ACFG.A as macro language
  3929.   variables. You can quickly edit this file by entering the "opena
  3930.   %acfg" command or by selecting the "Configuration.." menu item from
  3931.   the "Macro" pulldown menu.
  3932.  
  3933.   To change the value of a specific configuration setting, just locate
  3934.   the configuration setting in the file ACFG.A and use The Aurora Editor
  3935.   to type in the new value. Then save it <F3>, and enter the "setres"
  3936.   <Alt-F2> command ("Restore Settings" on the "Set" pull-down menu). You
  3937.   must exit and re-enter the editor for the new configuration setting to
  3938.   take effect.
  3939.  
  3940.   The following sections describe each of the configuration settings.
  3941.   Acceptable values for each configuration setting are shown in
  3942.   parentheses after the variable. Multiple values are separated by a
  3943.   slash ('/'), and value ranges are indicated with a hyphen ('-'). For
  3944.   configuration settings where "y/n" (Yes or No) can be specified,
  3945.   specifying "null" (blank) is equivalent to specifying "n".
  3946.  
  3947.  
  3948.   17-2  Configuration - Video
  3949.   ───────────────────────────
  3950.  
  3951.   - VidCols (0/40/80)
  3952.  
  3953.     The number of video columns. If zero is specified, The Aurora Editor
  3954.     uses the current DOS default value. The installation default is 0.
  3955.  
  3956.   - VidRows (0/12/14/21/25/28/43/50)
  3957.  
  3958.     The number of video rows. If zero is specified, The Aurora Editor
  3959.     uses the current DOS default value. The installation default is 0.
  3960.  
  3961.   - VidStr
  3962.  
  3963.     Specifies the string used to fill the video background. The string
  3964.     may be 0-50 chars long. You can use this setting to create
  3965.     interesting background patterns. The installation default is "░".
  3966.  
  3967.     If "VidStr" is null or not specified, The Aurora Editor will not
  3968.     change the screen background. The background will be whatever is on
  3969.     the screen when the editor is started.
  3970.  
  3971.   - VidSav (y/n)
  3972.  
  3973.     Specifies whether or not the DOS screen should be captured and
  3974.     restored when entering and exiting the editor (registered version
  3975.     only). The installation default is "y"
  3976.                                                       Configuration   74
  3977.  
  3978.  
  3979.   17-3  Configuration - Mouse
  3980.   ───────────────────────────
  3981.  
  3982.   - Mouse (y/n)
  3983.  
  3984.     Enables or disables mouse support. A text mode mouse driver
  3985.     (MOUSE.COM, MOUSE.SYS, etc) must have been previously installed. A
  3986.     special mouse driver may be required to operate the editor in a
  3987.     video modes with 132 or more columns. The installation default is
  3988.     "y".
  3989.  
  3990.   - MouReverse (y/n)
  3991.  
  3992.     Reverses the left and right mouse buttons. This can be useful for
  3993.     left-handed mouse users. The installation default is "n".
  3994.  
  3995.   - MouSenX (0-64)
  3996.  
  3997.     Mouse sensitivity on the x-axis. The installation default is 5 (the
  3998.     mouse driver default is 8).
  3999.  
  4000.   - MouSenY (0-64)
  4001.  
  4002.     Mouse sensitivity on the y-axis. The installation default is 12 (the
  4003.     mouse driver default is 16).
  4004.  
  4005.   - MouDst (0-128)
  4006.  
  4007.     Mouse speed doubling threshold. The installation default is 50 (the
  4008.     mouse driver default is 64).
  4009.  
  4010.   - MouseDouble (0-1000)
  4011.  
  4012.     The double click sensitivity. This setting specifies a time interval
  4013.     in milliseconds below which two consecutive mouse button clicks are
  4014.     considered to be a "double-click". The installation default value is
  4015.     300.
  4016.  
  4017.   - MouHold (0-1000)
  4018.  
  4019.     Specifies the amount of time in milliseconds that a mouse button can
  4020.     be held down on a scroll bar before repeating the scrolling
  4021.     operation. The installation default is 300.
  4022.  
  4023.   - MouDelay (0-1000)
  4024.  
  4025.     Adjusts the scrolling speed when using the mouse. A value of zero is
  4026.     no delay, 1000 is a one second delay. Using a value of zero on
  4027.     faster computers may cause the mouse to scroll too fast (8, 16, 24,
  4028.     or 32 are recommended if zero is too fast). The installation default
  4029.     is zero.
  4030.                                                         Configuration 75
  4031.  
  4032.  
  4033.   - MouMrkS (l/r/s)
  4034.  
  4035.     Determines the default type of block mark created by single-clicking
  4036.     the left mouse button, dragging the mouse, and releasing the left
  4037.     mouse button. You can specify one of the following options:
  4038.  
  4039.       l - line marks
  4040.       r - column or rectangular marks
  4041.       s - character or "stream" marks
  4042.  
  4043.     Note: you can override the default mouse marking type by pressing
  4044.     the <Alt>, <Ctrl>, or <Shift> keys when marking with the mouse (see
  4045.     "Using Marked Blocks" 8-1).
  4046.  
  4047.   - MouMrkD (l/r/s)
  4048.  
  4049.     Determines the type of block mark created by double-clicking the
  4050.     left mouse button, dragging the mouse, and releasing the left mouse
  4051.     button. See "MouMrkS" above for a description of valid options.
  4052.  
  4053.  
  4054.   17-4  Configuration - Word Processing
  4055.   ─────────────────────────────────────
  4056.  
  4057.   - TabWidth (0-15999)
  4058.  
  4059.     Specifies the number of columns between tab stops for Interval Tabs.
  4060.     The installation default is "8" (for a description of the TabWidth
  4061.     setting see "Global Settings" 13-2).
  4062.  
  4063.   - Tabs
  4064.  
  4065.     Specifies the column positions to use for tabbing with the "ctab"
  4066.     <Tab>, <Shift-Tab> command when "Variable Tabs" is set ON (for a
  4067.     description of the Variable Tabs setting see "Window Settings"
  4068.     13-1).
  4069.  
  4070.     The installation default is "4 8 16 24 50 72".
  4071.  
  4072.   - VarTabs (y/n)
  4073.  
  4074.     Specifies whether or not the Variable Tabs setting should default to
  4075.     "ON" for new Edit windows. The installation default is "n" (for a
  4076.     description of the Variable Tabs setting, see "Window Settings"
  4077.     13-1).
  4078.  
  4079.     If "SaveWin" is ON, Edit windows will remember the Variable Tabs
  4080.     setting when they are closed and restore it when they are re-opened.
  4081.                                                       Configuration   76
  4082.  
  4083.  
  4084.   - SmartTabs (y/n)
  4085.  
  4086.     Specifies whether or not the Smart Tabs setting should default to
  4087.     "ON" for new Edit windows. The installation default is "n" (for a
  4088.     description of the Smart Tabs setting, see "Window Settings" 13-1).
  4089.  
  4090.     If "SaveWin" is ON, Edit windows will remember the Smart Tabs
  4091.     setting when they are closed and restore it when they are re-opened.
  4092.  
  4093.   - WordWrap (y/n)
  4094.  
  4095.     Specifies whether or not the Word Wrap setting should default to
  4096.     "ON" for new Edit windows. The installation default is "n" (for a
  4097.     description of the Word Wrap setting, see "Window Settings" 13-1).
  4098.  
  4099.     If "SaveWin" is ON, Edit windows will remember the Word Wrap setting
  4100.     when they are closed and restore it when they are re-opened.
  4101.  
  4102.   - LMargin (1-16000)
  4103.  
  4104.     Specifies the default left margin for Edit windows. The installation
  4105.     default is 3 (for a description of the Left Margin setting, see
  4106.     "Global Settings" 13-2).
  4107.  
  4108.   - RMargin (1-16000)
  4109.  
  4110.     Specifies the default right margin for Edit windows. The
  4111.     installation default is 72 (for a description of the Right Margin
  4112.     setting, see "Global Settings" 13-2).
  4113.  
  4114.   - Indent (0-15999)
  4115.  
  4116.     Specifies the amount of columns to indent a paragraph when reflowing
  4117.     a marked block. The installation default is zero (for a description
  4118.     of the Paragraph Indent setting, see "Global Settings" 13-2).
  4119.  
  4120.  
  4121.   17-5  Configuration - Default File Extensions
  4122.   ─────────────────────────────────────────────
  4123.  
  4124.   Default file extensions allow you to open a file at an Open prompt
  4125.   without specifying a file extension. For example, if you frequently
  4126.   edit the file "MYFILE.C" from a directory of all ".C" files, and ".C"
  4127.   is one of your default file extensions, you need only enter the string
  4128.   "MYFILE" at the Open prompt to open "MYFILE.C".
  4129.                                                       Configuration   77
  4130.  
  4131.  
  4132.   You can specify any number of default file extensions. Just set the
  4133.   configuration setting "DefExt" to a list of the default extensions you
  4134.   wish to use, separated by one or more spaces. The default extensions
  4135.   are "tried" in the order they are listed. For example:
  4136.  
  4137.     DefExt    @"c h txt"
  4138.  
  4139.   Using the above example: if you specify a name with no extension at an
  4140.   Open prompt, the editor will first try to open the file with the
  4141.   extension ".c", then the extension ".h", and finally the extension
  4142.   ".txt".
  4143.  
  4144.   The following are the default file extensions at installation: "c h
  4145.   cpp doc txt a asm pas inc bat".
  4146.  
  4147.  
  4148.   17-6  Configuration - Open Options
  4149.   ──────────────────────────────────
  4150.  
  4151.   - OpenOpt (z/f/c/n/e)
  4152.  
  4153.     Sets the default size and placement of Edit and File Manager windows
  4154.     on the screen (and whether or not new windows are created). You can
  4155.     use one of the following values:
  4156.  
  4157.       z - new windows are always maximized
  4158.       f - new windows are always "full screen" (like maximized, but the
  4159.           window borders are visible)
  4160.       c - new windows are the same size as the topmost window and are
  4161.           cascaded to bottom and left of the topmost window
  4162.       n - new windows are minimized
  4163.       e - a new window is not created when opening files. The file is
  4164.           loaded into the current Edit window. This option is added
  4165.           automatically if the "OneWindow" configuration setting is ON
  4166.           (see "Configuration - Editing Preferences" 17-8).
  4167.  
  4168.     The installation default is 'f'.
  4169.  
  4170.     Note: If The Aurora Editor is configured to remember previous window
  4171.     sizes and positions, "OpenOpt" applies only to new Edit and File
  4172.     Manager windows which are not "remembered" from previous sessions
  4173.     (see the "SaveWin" configuration setting 17-11).
  4174.  
  4175.   - LineDlm
  4176.  
  4177.     Specifies a line delimiter string of one or two bytes for opening
  4178.     files in non-binary mode. The line delimiter string can be set
  4179.     dynamically during an edit session (see the "Line Delimiter" setting
  4180.     13-2). The installation default is "0D0Ah" (carriage return and
  4181.     linefeed).
  4182.                                                       Configuration   78
  4183.  
  4184.  
  4185.   - BinaryLength (1-16000)
  4186.  
  4187.     Specifies the line length to use when opening files in binary mode.
  4188.     The binary line length can also be set dynamically during an edit
  4189.     session (see the "Binary Line Length" setting 13-2). The
  4190.     installation default is 64.
  4191.  
  4192.   - TruncLength (0-16000)
  4193.  
  4194.     The length at which lines are truncated when opening files. A value
  4195.     of zero indicates that the maximum line length (16000) should be
  4196.     used. The installation default is zero.
  4197.  
  4198.   - FmgrOpt (d/f/h/k)
  4199.  
  4200.     Specifies options for displaying File Manager windows. You can use
  4201.     any combination of the following values:
  4202.  
  4203.       d - display subdirectories
  4204.       f - display directories first when sorting by name
  4205.       h - show hidden and system files
  4206.       k - show file sizes and totals in 1K increments
  4207.  
  4208.     The installation default is "dhf".
  4209.  
  4210.   - FmgrSrt (n/s/d)
  4211.  
  4212.     Specifies the default sort order for File Manager windows. You can
  4213.     use one of the following values:
  4214.  
  4215.       n - sort by name in ascending order
  4216.       s - sort by size in descending order
  4217.       d - sort by date and time in descending order
  4218.       (null) - no sort (OS default order)
  4219.  
  4220.     The installation default is "n".
  4221.  
  4222.   - FmgrQuit (y/n)
  4223.  
  4224.     Specifies whether or not the File Manager window is to be
  4225.     automatically closed whenever a file is opened from it. The
  4226.     installation default is "n".
  4227.  
  4228.     Note: entering the "fopen %q" <Ctrl-Enter> command from a File
  4229.     Manager window will also open the file at cursor AND close the File
  4230.     Manger window.
  4231.                                                       Configuration   79
  4232.  
  4233.  
  4234.   17-7  Configuration - Save Options
  4235.   ──────────────────────────────────
  4236.  
  4237.   - Backup (y/n)
  4238.  
  4239.     Specifies whether or not a file should be backed-up when it is
  4240.     saved. The backup location is determined by the "BakDir" setting
  4241.     (see below). The installation default is "y".
  4242.  
  4243.   - BakDir
  4244.  
  4245.     Specifies the path where backup copies of a file are to be placed
  4246.     when saving the file (the "Backup" setting must be set to "y"). If
  4247.     "BakDir" is null, then the backup copy is placed in the same
  4248.     directory as the original file, but with the extension defined by
  4249.     the "BakExt" configuration setting (see below). The installation
  4250.     default for BakDir is null.
  4251.  
  4252.   - BakExt
  4253.  
  4254.     Specifies the backup file extension to use when the "BakDir"
  4255.     configuration setting is null (see above). The installation default
  4256.     is "BAK".
  4257.  
  4258.   - SaveEOF (y/n)
  4259.  
  4260.     Specifies whether or not a Ctrl-Z (end-of-file) character is to be
  4261.     appended to the end of the file when saving. The installation
  4262.     default is "n".
  4263.  
  4264.   - AutoSave (0-2147483)
  4265.  
  4266.     Specifies the number of seconds between automatic saves for the
  4267.     current Edit window. A value of zero disables Autosave. The
  4268.     installation default is zero.
  4269.  
  4270.     Note: Automatic saves will occur only if the file has been modified
  4271.     since the last save.
  4272.  
  4273.  
  4274.   17-8  Configuration - Editing Preferences
  4275.   ─────────────────────────────────────────
  4276.  
  4277.   - UndoSize (0-2147483647)
  4278.  
  4279.     Sets the limit on the number of editing changes that can be undone
  4280.     with the Undo and Redo commands. The installation default is 300.
  4281.                                                       Configuration   80
  4282.  
  4283.  
  4284.   - HistSize (0-1000)
  4285.  
  4286.     Sets the limit on the number of previously entered prompt strings or
  4287.     "history" which can be retrieved for each prompt (see "Prompts"
  4288.     2-6). The installation default is 50.
  4289.  
  4290.     If the configuration setting "SaveWin" is ON, the HistSize setting
  4291.     also determines the maximum number of Edit and File Manager windows
  4292.     that will remember their positions and sizes.
  4293.  
  4294.     Note: if the "SaveHis" configuration setting is ON, and HistSize is
  4295.     set to very large values, it can lengthen the initial time to load
  4296.     the editor and the time to exit the editor. Don't set HistSize much
  4297.     higher than you really need.
  4298.  
  4299.   - ClipName
  4300.  
  4301.     Specifies the default clipboard name. The installation default is
  4302.     "clipboard".
  4303.  
  4304.   - Insert (y/n)
  4305.  
  4306.     Specifies whether or not the cursor will default to insert or
  4307.     overlay mode for new Edit windows and prompts. The installation
  4308.     default is "n".
  4309.  
  4310.     If "SaveWin" is ON, Edit windows will remember the insert mode when
  4311.     they are closed and restore it when they are re-opened.
  4312.  
  4313.   - EnterIns (i/s/null)
  4314.  
  4315.     Specifies what action to take in an Edit window when insert mode is
  4316.     ON and the "enteredit" <Enter> command is entered. You can choose
  4317.     one of the following values:
  4318.  
  4319.       s - splits the current line at the cursor and moves the cursor to
  4320.           the beginning of the next line
  4321.       i - inserts a new line and moves the cursor to the beginning of
  4322.           the new line.
  4323.       null - moves the cursor the beginning of the next line
  4324.  
  4325.     The installation default is OFF.
  4326.  
  4327.   - EnterOvl (i/s/null)
  4328.  
  4329.     Specifies what action to take in an Edit window when insert mode is
  4330.     OFF and the <Enter> key is pressed (See "EnterIns" above for a
  4331.     description of the valid values for this setting). The installation
  4332.     default is OFF.
  4333.                                                       Configuration   81
  4334.  
  4335.  
  4336.   - TabShift (y/n)
  4337.  
  4338.     Specifies whether or not text is to be shifted left or right with
  4339.     the cursor when insert mode is ON and the "ctab" commands <Tab>,
  4340.     <Shift-Tab> are is entered. The installation default is "y".
  4341.  
  4342.   - AutoIndent (y/n)
  4343.  
  4344.     Specifies whether or not the AutoIndent setting should default to ON
  4345.     for new Edit windows (see the "AutoIndent Setting" 13-1). The
  4346.     installation default is "y".
  4347.  
  4348.     If "SaveWin" is ON, Edit windows will remember the autoindent
  4349.     setting when they are closed and restore it when they are re-opened.
  4350.  
  4351.   - CopyLine (y/n)
  4352.  
  4353.     Specifies whether or not the "mcpy" command <Alt-C> ("Copy" on the
  4354.     "Block" pull-down menu) should repeat the current line if no marked
  4355.     block exists. The installation default is "y".
  4356.  
  4357.   - DelLine (y/n)
  4358.  
  4359.     Specifies whether or not the "mdel" command <Alt-D> ("Delete" on the
  4360.     "Block" pull-down menu) should delete the current line if no marked
  4361.     block exists. The installation default is "n".
  4362.  
  4363.   - AutoMark (p/l)
  4364.  
  4365.     Specifies the default mark that some block commands should use when
  4366.     no marked block exists. This can be especially useful for block
  4367.     commands like "mrfl %b" <Alt-R> ("Reflow" on the "Block" pull-down
  4368.     menu). For example, if AutoMark is set to "ptb", you can reflow a
  4369.     paragraph simply by placing the cursor in the paragraph and pressing
  4370.     <Alt-R>, without marking and unmarking a block.
  4371.  
  4372.     You can choose any one of the following values for AutoMark:
  4373.  
  4374.       p - mark the paragraph at the cursor
  4375.       l - mark the line at the cursor
  4376.       null - disable AutoMark
  4377.  
  4378.     If "p" is specified, one or both of the following values must also
  4379.     be specified:
  4380.  
  4381.       t - extend the mark from the cursor to the top of the paragraph
  4382.       b - extend the mark from the cursor to the bottom of the paragraph
  4383.                                                       Configuration   82
  4384.  
  4385.  
  4386.     Commands that use the AutoMark setting are:
  4387.  
  4388.       - mshf       "Shift Left", "Shift Right"
  4389.       - askmfill   "Fill"
  4390.       - mrfl       "Reflow", "Reflow Rjust"
  4391.       - mcase      "Uppercase", "Lowercase", "Flipcase"
  4392.       - msrt       "Sort"
  4393.       - mjust      "Left Justify", "Right Justify", "Center"
  4394.       - mfld       "Fold Block", "Fold Block Flat"
  4395.       - clpcpy     clipboard "Cut", "Cut Append", "Copy", "Copy Append"
  4396.  
  4397.     The installation default for AutoMark is "ptb".
  4398.  
  4399.   - MoveMark (y/n)
  4400.  
  4401.     Specifies whether or not the marked block is to be relocated along
  4402.     with the text during a block copy or overlay. The installation
  4403.     default is "y".
  4404.  
  4405.   - DrawMark (y/n)
  4406.  
  4407.     Specifies whether or not a marked block can be resized with the
  4408.     cursor keys after the mark is created. DrawMark applies only to the
  4409.     "mset" command (Mark Character, Mark Column, and Mark Line), not to
  4410.     "wrdmrk" (Mark Word), "meol" (Mark to EOL), or "mpgh" (Mark
  4411.     Paragraph). The installation default is "y".
  4412.  
  4413.   - CurHigh (y/n)
  4414.  
  4415.     Specifies whether or not the Edit window cursor line should be
  4416.     highlighted. The installation default is "y".
  4417.  
  4418.   - RepEnd (y/n)
  4419.  
  4420.     Specifies whether or not consecutively entered "ceol" <End> and
  4421.     "chome" <Home> commands should be repeated on the next or previous
  4422.     line. The installation default is "n".
  4423.  
  4424.   - DelJoin (y/n)
  4425.  
  4426.     Specifies whether or not the "delch" <Del> and "wrddel" <Ctrl-T>
  4427.     commands should join lines when the cursor is at the end of a line.
  4428.     The installation default is "y".
  4429.  
  4430.   - BakJoin (y/n)
  4431.  
  4432.     Specifies whether or not the "baksp" <BackSpace> command should join
  4433.     the current line with the previous line when the cursor is at column
  4434.     one. The installation default is "y".
  4435.                                                       Configuration   83
  4436.  
  4437.  
  4438.   - BakOvl (y/n)
  4439.  
  4440.     Specifies whether or not the "baksp" <BackSpace> command should
  4441.     overlay columns with blank spaces when insert mode is ON, instead of
  4442.     shifting text to the left. The installation default is "n".
  4443.  
  4444.   - LineStyle (0/1/2/3/4)
  4445.  
  4446.     Specifies the default Line Style to be used when Line Draw is ON.
  4447.     You can choose one of the following values:
  4448.  
  4449.       0 - single line
  4450.       1 - double horizontal line
  4451.       2 - double vertical line
  4452.       3 - double line
  4453.       4 - erase
  4454.  
  4455.     The installation default is 0.
  4456.  
  4457.   - FastCursor (0-5)
  4458.  
  4459.     Specifies the amount of extra lines or columns to scroll when
  4460.     attempting to move the cursor beyond the edge of the screen. The
  4461.     installation default is 0.
  4462.  
  4463.   - MatchChar (y/n)
  4464.  
  4465.     Specifies whether or not the Match Character setting should default
  4466.     to ON for new Edit windows (see the "Match Character Setting" 12.1).
  4467.     The installation default is "n".
  4468.  
  4469.     If "SaveWin" is ON, Edit windows will remember the Match Character
  4470.     setting when they are closed and restore it when they are re-opened.
  4471.  
  4472.   - MultCopy (y/n)
  4473.  
  4474.     Specifies whether or not The Aurora Editor will allow you to edit
  4475.     more than one copy of the same file (or display more than one File
  4476.     Manager window with the same directory listing) at the same time.
  4477.     The installation default is "n".
  4478.  
  4479.   - OneWindow (y/n)
  4480.  
  4481.     Specifies whether or not some editor commands will favor a
  4482.     many-to-one "file to window" ratio over a one-to-one "file to
  4483.     window" ratio. If this option is "y", the editor will behave in the
  4484.     following ways:
  4485.  
  4486.       - new files will be loaded into the current Edit window
  4487.       - the "fquit" <Alt-Q> command closes the file, not the window
  4488.       - the "wquit" <Ctrl-K-Q> command closes the window, not the file
  4489.  
  4490.     The installation default is "n" (see also "Saving and Discarding
  4491.     Files" 5-2).
  4492.                                                       Configuration   84
  4493.  
  4494.  
  4495.   - CurOT (0-99)
  4496.  
  4497.     Specifies the top of the visible cursor in overlay mode (on a scale
  4498.     of 0-99 with 0 at the top). The installation default is 80.
  4499.  
  4500.   - CurOB (0-99)
  4501.  
  4502.     Specifies the bottom of the visible cursor in overlay mode. The
  4503.     installation default is 90.
  4504.  
  4505.   - CurIT (0-99)
  4506.  
  4507.     Specifies the top of the visible cursor in insert mode. The
  4508.     installation default is 50.
  4509.  
  4510.   - CurIB (0-99)
  4511.  
  4512.     Specifies the bottom of the visible cursor in insert mode. The
  4513.     installation default is 90.
  4514.  
  4515.   - SearchOpt (i/r/b/g/w)
  4516.  
  4517.     Specifies the default search options for the find, replace, and scan
  4518.     dialog boxes and prompts. The following options may be specified:
  4519.  
  4520.       i - ignore case
  4521.       r - search in reverse
  4522.       b - marked block only
  4523.       g - global search
  4524.       w - whole words only
  4525.  
  4526.     The installation default is "i" (ignore case). See the section
  4527.     "Search and Replace" (11-1) for a detailed description of search
  4528.     options.
  4529.  
  4530.   - ReplaceOpt (a)
  4531.  
  4532.     Specifies the default replace options for the replace dialog box or
  4533.     prompt. The following option may be specified:
  4534.  
  4535.       a - replace all occurrences without prompting
  4536.  
  4537.     See the section "Search and Replace" (11-1) for a detailed
  4538.     description of replace options. The installation default is null
  4539.     (verify replacement).
  4540.  
  4541.   - SearchWrap (y/n)
  4542.  
  4543.     Specifies whether or not the "finl" <Ctrl-L> (repeat last
  4544.     find/replace) command should wrap to the top or bottom of the file
  4545.     when the search string is not found. The installation default is
  4546.     "n".
  4547.                                                       Configuration   85
  4548.  
  4549.  
  4550.   - EOTLine
  4551.  
  4552.     This setting specifies the string to be used as the "End-of-Text"
  4553.     line on Edit windows. If NULL is specified, the default End-of-Text
  4554.     Line is:
  4555.  
  4556.       "≡≡≡≡≡≡ End of Text ≡≡≡≡≡≡".
  4557.  
  4558.     The installation default is null.
  4559.  
  4560.   - ExitOpen (y/n)
  4561.  
  4562.     Specifies whether or not the Open promt is to be displayed when
  4563.     closing the last window in an edit session. If "n" is specified,
  4564.     closing the last window will return you to DOS. The installation
  4565.     default is "n".
  4566.  
  4567.     Note: the open prompt is not displayed when exiting the editor via
  4568.     the "gquit %p" <Alt-X> or "gquit %f" commands.
  4569.  
  4570.   - Prompts
  4571.  
  4572.     This setting is a 20 character string with "switches" at each
  4573.     character position that allow you to individually tailor most editor
  4574.     prompts. Each character position or "switch" in the string
  4575.     corresponds to a specific editor prompt and may be one of the
  4576.     following values:
  4577.  
  4578.       0 - (command line prompt) The prompt occupies only one line and
  4579.           is displayed at the top or bottom of the window.
  4580.  
  4581.       1 - (one-line box) The prompt occupies 3 lines (2 borders and 1
  4582.           command line) and is displayed immediately above or below the
  4583.           current cursor position.
  4584.  
  4585.       2 - (dialog box) The prompt is a dialog box.
  4586.  
  4587.     The following table shows the Prompt string positions and the
  4588.     associated prompts:
  4589.  
  4590.        1 - open                       11 - macro command
  4591.        2 - open and insert            12 - key macro open
  4592.        3 - rename                     13 - key macro save
  4593.        4 - save as                    14 - place & go to bookmark
  4594.        5 - os command                 15 - block fill
  4595.        6 - save block                 16 - open binary
  4596.        7 - find
  4597.        8 - replace                    18 - global settings
  4598.        9 - go to line & column        19 - user defined prompts
  4599.       10 - scan files                 20 - file mgr command prompts
  4600.                                                       Configuration   86
  4601.  
  4602.  
  4603.     For example, the prompt string "01111102111111111111" will set the
  4604.     "Open" and "Find" prompts to be command line prompts, the "Replace"
  4605.     prompt to be a full dialog box, and all other prompts to be one-line
  4606.     boxes.
  4607.  
  4608.     The installation default is "11111111111111111111" (all one-line
  4609.     boxes).
  4610.  
  4611.  
  4612.   17-9  Configuration - Window Preferences
  4613.   ────────────────────────────────────────
  4614.  
  4615.   - EditStyle (n/s/m/h/v/1)
  4616.  
  4617.     Specifies the window features to be displayed for Edit windows. You
  4618.     can specify any of the following options:
  4619.  
  4620.       n - north title bar
  4621.       s - south title bar
  4622.       m - menu bar
  4623.       h - horizontal scroll bar
  4624.       v - vertical scroll bar
  4625.       1 - tool bar
  4626.  
  4627.     The installation default is "nsmhv".
  4628.  
  4629.   - EditTitle (n/s/l/c/r)
  4630.  
  4631.     Specifies the location of the Edit window title. You can specify one
  4632.     of the following:
  4633.  
  4634.       n - north title bar
  4635.       s - south title bar
  4636.  
  4637.     You can also specify one of the following:
  4638.  
  4639.       l - left justified
  4640.       c - centered
  4641.       r - right justified
  4642.  
  4643.     The installation default is "nl".
  4644.  
  4645.   - EditStatus (n/s/l/c/r)
  4646.  
  4647.     Specifies the location of the Edit window status line. (See
  4648.     "EditTitle" above for valid options). The installation default is
  4649.     "nr".
  4650.                                                        Configuration   87
  4651.  
  4652.  
  4653.   - EditCtls (n/s)
  4654.  
  4655.     Specifies which Edit window title bar is to contain the title bar
  4656.     controls. You can specify one of the following:
  4657.  
  4658.       n - north title bar
  4659.       s - south title bar
  4660.  
  4661.     The installation default is "n".
  4662.  
  4663.   - FmgrStyle (n/s/m/h/v)
  4664.  
  4665.     Specifies the window features to be displayed for File Manager
  4666.     windows (see "EditStyle" above for valid options). The installation
  4667.     default is "nsmhv".
  4668.  
  4669.   - FmgrTitle (n/s/l/c/r)
  4670.  
  4671.     Specifies the location of the File Manager window title. (See
  4672.     "EditTitle" above for valid options). The installation default is
  4673.     "nl".
  4674.  
  4675.   - FmgrStatus (n/s/l/c/r)
  4676.  
  4677.     Specifies the location of the File Manager window status line. (See
  4678.     "EditTitle" above for valid options). The installation default is
  4679.     "sl".
  4680.  
  4681.   - FmgrCtls (n/s)
  4682.  
  4683.     Specifies which File Manager window title bar is to contain the
  4684.     title bar controls (See "EditCtls" above for valid options). The
  4685.     installation default is "n".
  4686.  
  4687.   - BoxStyle (f/i/o/0/1/2/3/4/5/6)
  4688.  
  4689.     Specifies the border style for one-line box prompt windows. You can
  4690.     specify one of the following:
  4691.  
  4692.       f - flat
  4693.       i - inward 3D effect
  4694.       o - outward 3D effect
  4695.  
  4696.     You can also specify a border type from 0 to 6:
  4697.                                                       Configuration   88
  4698.  
  4699.       0 - blank
  4700.       1 - single line
  4701.       2 - double horizontal
  4702.       3 - double vertical
  4703.       4 - double line
  4704.       5 - solid
  4705.       6 - blank
  4706.  
  4707.     The installation default is "i1".
  4708.  
  4709.   - DlgStyle (f/i/o/0/1/2/3/4/5/6)
  4710.  
  4711.     Specifies the border style for dialog box prompt windows. See
  4712.     "BoxStyle" above for valid options. The installation default is
  4713.     "i1".
  4714.  
  4715.   - TileNum (1-5)
  4716.  
  4717.     This option is used to configure the window "Tiling" commands. It
  4718.     specifies the maximum number of tiles which can exist on the screen
  4719.     before they are split in both horizontal and vertical directions.
  4720.     The installation default is 3.
  4721.  
  4722.  
  4723.   17-10  Configuration - Print Settings
  4724.   ─────────────────────────────────────
  4725.  
  4726.   Print settings are available for controlling the format of printed
  4727.   output. These settings can be changed during an edit session using the
  4728.   "askprtset" command (see "Printing" 12-1). The Print Settings are:
  4729.  
  4730.   - PrtDev (PRN/LPT1/LPT2/LPT3/LPT4/COM1/COM2 or filename)
  4731.  
  4732.     Specifies the printer device to be used for printing. If a filename
  4733.     is specified, all printer output will be routed to the file. The
  4734.     installation default is "PRN".
  4735.  
  4736.   - PrtPag (0-65535)
  4737.  
  4738.     Specifies the "Lines per Page" of printed output. This includes the
  4739.     Top and Bottom Margins (if any). After the specified lines per page
  4740.     have been printed, a formfeed character (ascii 12) will be sent to
  4741.     the printer and a new page will be started.
  4742.  
  4743.     If PrtPag is zero, printing will be continuous (no formfeed
  4744.     characters will be sent to the printer). The current printer
  4745.     settings for Top Margin, Bottom Margin, Header, Footer, and Page
  4746.     number will be ignored. If you already have special printer control
  4747.     characters embedded in your text, it is probably best to set PrtPag
  4748.     to zero.
  4749.  
  4750.     The installation default for PrtPag is 0.
  4751.                                                       Configuration   89
  4752.  
  4753.   - PrtSpace (0-65535)
  4754.  
  4755.     This setting determines the number of lines to advance after
  4756.     printing each line of output. A value of 1 generates single-spaced
  4757.     output, 2 generates double-spaced output, and so on. The
  4758.     installation default for PrtSpace is 1.
  4759.  
  4760.   - PrtCop (0-65535)
  4761.  
  4762.     This setting determines the number of copies to print. The
  4763.     installation default is 1.
  4764.  
  4765.   - PrtIni
  4766.  
  4767.     Specifies a printer-specific control string to be sent to the
  4768.     printer before each print command. The installation default is null.
  4769.  
  4770.   - PrtTop (0-65535)
  4771.  
  4772.     Specifies the number of blank lines to precede the printed output at
  4773.     the top of each page. This value is included in the PrtPag ("Lines
  4774.     per Page") setting. The installation default is zero.
  4775.  
  4776.     This setting is ignored if PrtPag ("Lines per Page") is set to zero.
  4777.  
  4778.   - PrtBot (0-65535)
  4779.  
  4780.     Specifies the number of blank lines to follow the printed output at
  4781.     the end of each page. This value is included in the PrtPag ("Lines
  4782.     per Page") setting. The installation default is zero.
  4783.  
  4784.     This setting is ignored if PrtPag ("Lines per Page") is set to zero.
  4785.  
  4786.   - PrtLeft (0-255)
  4787.  
  4788.     Specifies the number of blank columns to precede the printed output
  4789.     on each line. The installation default is zero.
  4790.  
  4791.   - PrtRight (0-65535)
  4792.  
  4793.     Specifies the column position at which to truncate each printed
  4794.     line. This column position is relative to column zero of the printed
  4795.     output, NOT the file being printed. If zero is specified, lines are
  4796.     not truncated. The installation default is zero.
  4797.  
  4798.   - PrtOpt (h/f/p/l/e/s)
  4799.  
  4800.     This setting allows you specify additional default print options.
  4801.     You can specify any of the following options:
  4802.                                                       Configuration   90
  4803.  
  4804.  
  4805.       h - prints a "header" at the top of each page. The header is a
  4806.           left justified string consisting of the filename being printed
  4807.           and the current date and time. The header uses 2 or 3 lines of
  4808.           the printed output (the header line, an optional separator
  4809.           line, and a blank line). This option is ignored if PrtPag
  4810.           ("Lines per Page") is set to zero.
  4811.  
  4812.       f - prints a "footer" at the bottom of each page. The footer is a
  4813.           left justified string consisting of the filename being printed
  4814.           and the current date and time. The footer uses 2 or 3 lines of
  4815.           the printed output (a blank line, an optional separator line,
  4816.           and the footer line). This option is ignored if PrtPag ("Lines
  4817.           per Page") is set to zero.
  4818.  
  4819.       p - prints a right-justified page number on the header and footer
  4820.           lines. If neither a header or footer was specified, a blank
  4821.           header line is assumed. This option is ignored if PrtPag
  4822.           ("Lines per Page") is set to zero.
  4823.  
  4824.       l - prints the line number (in the file) at the beginning of each
  4825.           line.
  4826.  
  4827.       e - sends a formfeed character to the printer when printing is
  4828.           completed.
  4829.  
  4830.       s - prints a separator line after the header line and before the
  4831.           footer line.
  4832.  
  4833.     The installation default is "hpes".
  4834.  
  4835.  
  4836.   17-11  Configuration - Desktop Options
  4837.   ──────────────────────────────────────
  4838.  
  4839.   - SaveWin (y/n)
  4840.  
  4841.     For Edit windows and File Manager windows, this setting specifies
  4842.     whether or not window sizes, positions, settings, and cursor
  4843.     positions should be remembered when the window is closed and
  4844.     restored when the window is re-opened. The installation default is
  4845.     "y".
  4846.  
  4847.     The "HistSize" setting determines the maximum number of windows that
  4848.     will remember their sizes, positions, etc. When a new Edit window or
  4849.     File Manager window is opened which is not a "remembered" window,
  4850.     the least-recently remembered window is "forgotten" and the new
  4851.     window becomes one of the "remembered" windows. The number of
  4852.     "remembered" windows does not exceed HistSize.
  4853.                                                       Configuration   91
  4854.  
  4855.   - SaveHis (y/n)
  4856.  
  4857.     Specifies whether or not prompt history and window sizes, positions,
  4858.     etc should be saved in the file A.HIS when exiting the editor and
  4859.     reloaded when re-entering the editor. The installation default is
  4860.     "y".
  4861.  
  4862.   - SaveMac (y/n)
  4863.  
  4864.     Specifies whether or not all resident key macros should be saved in
  4865.     the file "A.MAC" when exiting the editor and reloaded when
  4866.     re-entering. The installation default is "n".
  4867.  
  4868.   - BootOpt (d/f/o)
  4869.  
  4870.     Determines what action to take when the editor is loaded without
  4871.     specifying a filename or directory after the "A" or "A3" command.
  4872.     One of the following options may be specified:
  4873.  
  4874.       d - restores the previous desktop layout. The "SaveHis"
  4875.           configuration setting must also be set to "y" (see above).
  4876.       f - opens a File Manager window for the current directory
  4877.       o - displays an Open prompt
  4878.  
  4879.     The installation default is "d".
  4880.  
  4881.  
  4882.   17-12  Configuration - Memory Options
  4883.   ─────────────────────────────────────
  4884.  
  4885.   - MaxXMS (-1 - 67108)
  4886.   - MaxEMS (-1 - 32767)
  4887.  
  4888.     These configuration settings specify the maximum amount of Extended
  4889.     Memory "XMS" and Expanded Memory "EMS" (in kilobytes) which The
  4890.     Aurora Editor may use when conventional memory (below 640k) is
  4891.     exhausted. If the amount specified is "-1", or is more than what is
  4892.     available, then the maximum available amount will be used. If zero
  4893.     is specified, then the usage of XMS and/or EMS memory will be
  4894.     disabled. The installation default is -1 (available maximum) for
  4895.     both "MaxXMS" and "MaxEMS".
  4896.  
  4897.     XMS and EMS memory are not required by The Aurora Editor, but they
  4898.     can speed up some editing operations when you are working with
  4899.     single or multiple files which are larger than the amount of
  4900.     available conventional memory. In memory intensive situations, The
  4901.     Aurora Editor will first try to use XMS memory, then EMS memory, and
  4902.     then swap to disk if XMS or EMS are not available.
  4903.                                                       Configuration   92
  4904.  
  4905.  
  4906.     Note that it can be useful to restrict the amount of XMS or EMS
  4907.     memory used by The Aurora Editor to less than the available maximum.
  4908.     The editor will use only as much XMS and EMS as it needs. However if
  4909.     you are editing large files and executing programs from within the
  4910.     editor that use XMS or EMS (or that use DOS extenders which use XMS
  4911.     or EMS), these programs may not run correctly if The Aurora Editor
  4912.     has already allocated all available XMS or EMS.
  4913.  
  4914.     To allow The Aurora Editor to use XMS or EMS memory, you must also
  4915.     have previously installed an XMS-compatible or EMS-compatible
  4916.     driver, such as QEMM-386 from Quarterdeck Office Systems or 386MAX
  4917.     from Qualitas, Inc. If you have DOS 5.0 or higher, you can use the
  4918.     XMS driver HIMEM.SYS and the EMS driver EMM386.EXE. Note that in
  4919.     order to use EMS memory, you must have at least a full contiguous
  4920.     64k page frame available. Check your EMS driver documentation for
  4921.     details on how to configure the page frame.
  4922.  
  4923.     When the XMS and EMS drivers are installed, you can display the
  4924.     amount of available XMS and EMS memory from DOS by using the DOS
  4925.     "MEM" command (DOS 5.0 or greater).
  4926.  
  4927.   - SwapFile1
  4928.  
  4929.     Specifies the swapfile name to be used for the primary swapfile. The
  4930.     installation default is "c:\aurora@1.swp".
  4931.  
  4932.  
  4933.   - SwapFile2
  4934.  
  4935.     Specifies the swapfile name to be used for the secondary swapfile.
  4936.     The secondary swapfile should always be on a different drive than
  4937.     the primary swapfile. The secondary swapfile will only be used if
  4938.     there is not enough space on the drive containing the primary
  4939.     swapfile. The installation default is "d:\aurora@2.swp".
  4940.  
  4941.  
  4942.   17-13  Configuration - Other Options
  4943.   ────────────────────────────────────
  4944.  
  4945.   - KeyEnh (y/n)
  4946.  
  4947.     Enables or disables checking for the enhanced keyboard. This option
  4948.     must be set to "y" to use the enhanced keyboard keys (F11, F12, grey
  4949.     cursor keys, etc). The installation default is "y".
  4950.  
  4951.   - KeyPad (y/n)
  4952.  
  4953.     Enables or disables use of the grey keypad keys (*,-,+,Enter) as
  4954.     function keys (this option should be disabled if you are using the
  4955.     editor for keypad data entry). The installation default is "y".
  4956.                                                       Configuration   93
  4957.  
  4958.   - KeyTrim (y/n)
  4959.  
  4960.     Specifies whether or not the keyboard buffer should be "trimmed" to
  4961.     prevent it from filling up on very slow machines. Turning this
  4962.     setting ON may cause some TSR's that fill the keyboard buffer to
  4963.     work incorrectly. The installation default is "n".
  4964.  
  4965.   - Sound (y/n)
  4966.  
  4967.     Enables or disables sound. The installation default is "y".
  4968.  
  4969.   - SoundF
  4970.  
  4971.     Specifies the sound frequency in hertz for beep messages. The
  4972.     installation default is 200.
  4973.  
  4974.  
  4975.   17-14  Configuration - Character Sets
  4976.   ─────────────────────────────────────
  4977.  
  4978.   Character sets are used to define a "word" for some editor commands.
  4979.   Characters sets are defined by creating a string containing all the
  4980.   characters in the character set. Character "ranges" can be abbreviated
  4981.   by using hyphens (-) (A-Z, 0-9, etc).
  4982.  
  4983.   The default character sets are:
  4984.  
  4985.   - CSetA
  4986.  
  4987.     The definition of a "word" for commands operating on normal text.
  4988.     The installation default is "a-zA-Z0-9_".
  4989.  
  4990.   - CSetB
  4991.  
  4992.     The definition of a "word" for commands operating on file names. The
  4993.     installation default is "a-zA-Z0-9_()\-./\\@{}~:^!#$%&`'".
  4994.  
  4995.   - CSet
  4996.  
  4997.     The "default" character set. The installation default is "CSetA"
  4998.  
  4999.  
  5000.   The following commands use character sets:
  5001.  
  5002.     - wrddel  CSet     "Delete Word"       <Ctrl-T>
  5003.     - wrdmrk  CSet     "Mark Word"         <Alt-1>
  5004.     - cwrd %l CSet     (find left word)    <Ctrl-Left>
  5005.     - cwrd %r CSet     (find right word)   <Ctrl-Right>
  5006.     - wrdlod  CSetB    (load file at the cursor)   <Ctrl-]>
  5007.     - all search & replace commands using the "Whole Words"
  5008.       search option (uses "CSet")
  5009.                                                       Configuration   94
  5010.  
  5011.  
  5012.   17-15  Configuration - Text Translation
  5013.   ───────────────────────────────────────
  5014.  
  5015.   See Text Translation (18-7) for a detailed description of text
  5016.   translation.
  5017.  
  5018.   - TextTran (y/n)
  5019.  
  5020.     Specifies whether or not the Text Translation setting should default
  5021.     to "ON" for new Edit windows. The installation default is "n".
  5022.  
  5023.     If "SaveWin" is ON, Edit windows will remember the Text Translation
  5024.     setting when they are closed and restore it when they are re-opened.
  5025.  
  5026.   - TranObj
  5027.  
  5028.     Specifies the name of the macro language object to be used for Text
  5029.     Translation. This variable can be changed dynamically through the
  5030.     macro language. The installation default is "trn".
  5031.  
  5032.   - TranCSet
  5033.  
  5034.     Specifies the character set used to define a word for Text
  5035.     Translation. Character "ranges" can be abbreviated by using hyphens
  5036.     (A-Z, 0-9, etc). This variable can be changed dynamically through
  5037.     the macro language. The installation default is @"a-zA-Z0-9_;"
  5038.  
  5039.  
  5040.   17-16  Configuration - Confirmations
  5041.   ────────────────────────────────────
  5042.  
  5043.   - ConDel (y/n)
  5044.  
  5045.     Specifies whether or not you wish to be prompted when files are
  5046.     deleted. The installation default is "y".
  5047.  
  5048.   - ConRpl (y/n)
  5049.  
  5050.     Specifies whether or not you wish to be prompted when files are
  5051.     replaced. The installation default is "y".
  5052.  
  5053.   - ConTch (y/n)
  5054.  
  5055.     Specifies whether or not you wish to be prompted when files are
  5056.     touched. The installation default is "y".
  5057.  
  5058.  
  5059.   17-17  Configuration - Colors
  5060.   ─────────────────────────────
  5061.  
  5062.   Colors attributes can be changed by setting the "coXXXX" configuration
  5063.   settings to the desired color attributes. You can change the color
  5064.   attributes for the screen background, Edit windows, File Manager
  5065.   windows, prompts, dialog boxes, and the screen border.
  5066.                                                       Configuration   95
  5067.  
  5068.  
  5069.   See the comments in the configuration file ACFG.A for a description of
  5070.   each of color setting.
  5071.  
  5072.   Color attributes for any desired color can be obtained by selecting a
  5073.   foreground number and a background number from the following tables,
  5074.   and adding them together:
  5075.  
  5076.     Foreground:                    Background:
  5077.  
  5078.     0 black     8 dark gray          0 black     128 dark gray
  5079.     1 blue      9 light blue        16 blue      144 light blue
  5080.     2 green    10 light green       32 green     160 light green
  5081.     3 cyan     11 light cyan        48 cyan      176 light cyan
  5082.     4 red      12 light red         64 red       192 light red
  5083.     5 magenta  13 light magenta     80 magenta   208 light magenta
  5084.     6 brown    14 yellow            96 brown     224 yellow
  5085.     7 gray     15 white            112 gray      240 white
  5086.  
  5087.   For example, the color attribute for a white foreground on a blue
  5088.   background is 31 (15 + 16).
  5089.  
  5090.  
  5091.   17-18  Configuration - Borders
  5092.   ──────────────────────────────
  5093.  
  5094.   - Shadow (0-5)
  5095.  
  5096.     Specifies the thickness of the "shadow" on the right and bottom
  5097.     window borders. Specifying a thickness greater than one may provide
  5098.     better 3-D contrast in "denser" video modes. The installation
  5099.     default is 1.
  5100.  
  5101.   - BorT
  5102.  
  5103.     Specifies the border type to use for Edit windows and File Manager
  5104.     windows. You can choose one of the following border types:
  5105.  
  5106.       0 - expanded borders
  5107.       1 - single line
  5108.       2 - double horizontal
  5109.       3 - double vertical
  5110.       4 - double line
  5111.       5 - solid
  5112.       6 - blank
  5113.  
  5114.     If "expanded" is specified, you can further configure the border
  5115.     appearance with the BorX, BorY, and BorO configuration settings
  5116.     (see below). The installation default is 0 ("expanded").
  5117.                                                       Configuration   96
  5118.  
  5119.  
  5120.   - BorX (0-10)
  5121.  
  5122.     Specifies the left and right border thickness for "expanded"
  5123.     borders. The installation default is 1.
  5124.  
  5125.   - BorY (0-10)
  5126.  
  5127.     Specifies the top and bottom border thickness for "expanded"
  5128.     borders. The installation default is 1.
  5129.  
  5130.   - BorO (0-10)
  5131.  
  5132.     Specifies the amount of overlap on the "expanded" border corners.
  5133.     The installation default is 2.
  5134.                                              Redefining the Keyboard  97
  5135.  
  5136.  
  5137.   18-1  Redefining the Keyboard
  5138.   ─────────────────────────────
  5139.  
  5140.   Note: In reading through the following sections on redefining the
  5141.   keyboard, mouse, and menus, it may be helpful to refer to the "Aurora
  5142.   Editor Macro Language Guide" (AML.DOC).
  5143.  
  5144.   Key definitions and user macro code are stored in the file AKBD.A. You
  5145.   can quickly edit this file by entering the "opena %akbd" command or by
  5146.   selecting the "Keys.." item from the "Macro" pulldown menu.
  5147.  
  5148.   The key definitions in AKBD.A are actually source code written in The
  5149.   Aurora Macro Language. They are compiled and included into A.X when
  5150.   the "setres" <Alt-F2> command ("Restore Settings" on the "Set"
  5151.   pull-down menu) is entered.
  5152.  
  5153.   A key definition is really just a function defined within an Aurora
  5154.   Macro Language "event object" in the file AKBD.A. There are event
  5155.   objects for Edit windows, File Manager windows, Prompt windows, etc.
  5156.   For example:
  5157.  
  5158.     obj  edit (
  5159.       fun  k_f9   (osshell).
  5160.       fun  k_a_q  (quit %p).
  5161.     ).
  5162.  
  5163.   The above code defines two keys in the event object "edit" (which is
  5164.   active only for Edit windows). The <F9> key is defined to shell out
  5165.   to DOS, and the <Alt-Q> key is defined to close the current window.
  5166.  
  5167.   To change an existing key definition, simply locate the key definition
  5168.   in the file AKBD.A and use The Aurora Editor to change the function
  5169.   name (the "key name") or the function body (the "key definition")
  5170.   according to your preferences. The function name must be a key
  5171.   function name recognized by The Aurora Editor (see below). Then save
  5172.   AKBD.A <F3>, and enter the "setres" <Alt-F2> command ("Restore
  5173.   Settings" on the "Set" pull-down menu). You must exit and re-enter the
  5174.   editor for the new key definition to take effect.
  5175.  
  5176.   To add a new key definition, first decide in what types of windows you
  5177.   would like the key you are defining to be active, and then determine
  5178.   the right "event object" for those window types. You can choose from
  5179.   the following event objects:
  5180.  
  5181.     edit      - Edit windows only
  5182.     fmgr      - File Manager windows only
  5183.     edit-fmgr - Edit windows and File Manager windows
  5184.     prompt    - prompts and edit fields, Edit windows
  5185.     win       - movable or sizable windows
  5186.     mon       - all windows
  5187.                                              Redefining the Keyboard  98
  5188.  
  5189.  
  5190.   After you have determined the appropriate event object, locate the
  5191.   definition for the event object in AKBD.A and enter the new key
  5192.   definition function in the event object body. You must use a key
  5193.   function name which The Aurora Editor recognizes. For example:
  5194.  
  5195.  
  5196.     obj  edit (                            // the "edit" event object
  5197.       .                                    // event object body
  5198.       .
  5199.       fun  k_f4     (file).                // new key definition
  5200.       .                                    // key func name <F4>
  5201.       .
  5202.     ).
  5203.  
  5204.   After you have entered the new key definition, save AKBD.A <F3>, and
  5205.   enter the "setres" <Alt-F2> command ("Restore Settings" on the "Set"
  5206.   pulldown menu). You must exit and re-enter the editor for the new key
  5207.   definition to take effect.
  5208.  
  5209.   Mouse event handlers can also be redefined in the same way as keyboard
  5210.   definitions. As with key definitions, mouse function names must be
  5211.   recognized by The Aurora Editor (see "Mouse Function Names" 18-4).
  5212.  
  5213.   If you change keyboard definitions, you will probably also want to
  5214.   change any menu definitions which show the old key definitions. You
  5215.   may also want to update The Aurora Editor Quick Reference (AREF.DOC).
  5216.  
  5217.  
  5218.   18-2  Key Function Names
  5219.   ────────────────────────
  5220.  
  5221.   When defining a key function, you must use a key name recognized by
  5222.   The Aurora Editor. By convention, key names are always in lower case
  5223.   and begin with "k_". <Ctrl> key names begin with "k_c_", <Alt> key
  5224.   names begin with "k_a_", and <Shift> key names begin with "k_s_".
  5225.  
  5226.   To use the enhanced keyboard function keys (f11, f12, etc), the
  5227.   "KeyEnh" configuration setting must be set to "y" (see "Configuration
  5228.   - Other Options" 17-13).
  5229.  
  5230.   The following key names are recognized by The Aurora Editor (enhanced
  5231.   keyboard keys are prefixed with an asterisk "*"):
  5232.                                                  Key Function Names   99
  5233.  
  5234.  
  5235.     Standard/Shift Keys      Control Keys           Alt Keys
  5236.     ───────────────────      ────────────           ────────
  5237.  
  5238.     k_f1    - k_f10          k_c_f1  - k_c_f10      k_a_f1  - k_a_f10
  5239.    *k_f11   - k_f12         *k_c_f11 - k_c_f12     *k_a_f11 - k_a_f12
  5240.     k_s_f1  - k_s_f10
  5241.    *k_s_f11 - k_s_f12
  5242.                              k_c_a - k_c_z          k_a_a - k_a_z
  5243.                                                     k_a_0 - k_a_9
  5244.     k_backspace              k_c_backspace         *k_a_backspace
  5245.     k_tab                   *k_c_tab               *k_a_tab
  5246.     k_s_tab
  5247.     k_enter                  k_c_enter             *k_a_enter
  5248.     k_esc                                          *k_a_esc
  5249.     k_left                   k_c_left              *k_a_left
  5250.     k_right                  k_c_right             *k_a_right
  5251.     k_up                    *k_c_up                *k_a_up
  5252.     k_down                  *k_c_down              *k_a_down
  5253.     k_home                   k_c_home              *k_a_home
  5254.     k_end                    k_c_end               *k_a_end
  5255.     k_pgdn                   k_c_pgup              *k_a_pgup
  5256.     k_pgup                   k_c_pgdn              *k_a_pgdn
  5257.     k_ins                   *k_c_ins               *k_a_ins
  5258.     k_del                   *k_c_del               *k_a_del
  5259.    *k_pad5                  *k_c_pad5
  5260.     k_s_pad5
  5261.                              k_c_\                 *k_a_\
  5262.                              k_c_[
  5263.                              k_c_]                 *k_a_]
  5264.                              k_c_2
  5265.                              k_c_6
  5266.                              k_c_-                  k_a_-
  5267.                              k_c_prtsc
  5268.                                                     k_a_=
  5269.                                                    *k_a_[
  5270.                                                    *k_a_`
  5271.                                                    *k_a_'
  5272.                                                    *k_a_;
  5273.                                                    *k_a_/
  5274.                                                    *k_a_period
  5275.                                                    *k_a_comma
  5276.                             *k_c_grey/             *k_a_grey/
  5277.     k_grey*                 *k_c_grey*             *k_a_grey*
  5278.     k_grey-                 *k_c_grey-             *k_a_grey-
  5279.     k_grey+                 *k_c_grey+             *k_a_grey+
  5280.     *k_greyenter            *k_c_greyenter         *k_a_greyenter
  5281.  
  5282.     k_chr  (non-function keys)
  5283.                                             Defining Compound Keys   100
  5284.  
  5285.  
  5286.   18-3  Defining Compound Keys
  5287.   ────────────────────────────
  5288.  
  5289.   The Aurora Editor also allows you to define "compound keys". A
  5290.   Compound key is a combination of keys that act like one function key.
  5291.   Using compound keys can greatly expand the number of available
  5292.   function keys, or help to make The Aurora Editor behave like another
  5293.   editor or word processor.
  5294.  
  5295.   To form a compound key name, just concatenate all the composite key
  5296.   names (discarding the "k_" prefix), and separate them with the "+"
  5297.   character. Then attach the "k_" prefix to the beginning of the
  5298.   compound key.
  5299.  
  5300.   For example, "k_f1+f2" is the compound key name for <F1> and <F2>.
  5301.   "k_c_d+a_s+f3" is a compound key name composed of the 3 function keys:
  5302.   <Ctrl-D>, <Alt-S>, and <F3>. Compound keys names may also have a
  5303.   non-function key as the last key. For example, "k_c_d+k" is a valid
  5304.   compound key.
  5305.  
  5306.   To define compound keys, first define all keys in the compound key
  5307.   series (except for the last) as compound key "prefixes". This is done
  5308.   using the "keyx" function. For example:
  5309.  
  5310.     obj  edit (
  5311.        .
  5312.        .
  5313.       fun  k_c_d     (keyx "k_c_d").  //  define prefix "<Ctrl-D>"
  5314.       fun  k_c_d+f1  (save).          // "<Ctrl-D>,<F1>" saves the file
  5315.        .
  5316.        .
  5317.       fun  k_c_d+f2 (keyx "k_c_d+f2"). //  define prefix "<Ctrl-D>,<F2>"
  5318.       fun  k_c_d+f2+a  (quit %p).      // "<Ctrl-D>,<F2>,<A>" quits the file
  5319.        .
  5320.        .
  5321.     ).
  5322.  
  5323.   Note that when a function key is defined as a compound key prefix, it
  5324.   can no longer be used as a "normal" function key for another function.
  5325.  
  5326.   Compound keys have one restriction: you cannot assign a key macro to a
  5327.   compound key.
  5328.  
  5329.   The following compound key prefixes are defined in AKBD.A at
  5330.   installation time:
  5331.  
  5332.     - k_c_k  <Ctrl K>
  5333.     - k_c_o  <Ctrl O>
  5334.     - k_c_q  <Ctrl Q>
  5335.                                               Mouse Function Names   101
  5336.  
  5337.  
  5338.   18-4  Mouse Function Names
  5339.   ──────────────────────────
  5340.  
  5341.   You can configure the way Aurora Editor handles the mouse by creating
  5342.   your own "mouse event handler" functions. You can change existing
  5343.   mouse definitions and add new definitions just as you would for the
  5344.   keyboard (see "Redefining the Keyboard" 18-1).
  5345.  
  5346.   When defining a mouse handler function, you must use a mouse function
  5347.   name recognized by The Aurora Editor. By convention, mouse function
  5348.   names are always in lower case and begin with "m_". Mouse left button
  5349.   function names begin with "m_l_", mouse right button function names
  5350.   begin with "m_r_", and mouse center button function names begin with
  5351.   "m_c_".
  5352.  
  5353.   A mouse function name will have the suffix "_client" if the mouse
  5354.   event originated in a window client area, "_border" if it originated
  5355.   on a window border, or "_bkgnd" if it originated on the video
  5356.   background.
  5357.  
  5358.   The following mouse function names are recognized by The Aurora
  5359.   Editor:
  5360.  
  5361.     m_move_client         m_move_border         m_move_bkgnd
  5362.  
  5363.     m_l_down_client       m_l_down_border       m_l_down_bkgnd
  5364.     m_l_up_client         m_l_up_border         m_l_up_bkgnd
  5365.     m_l_dbclick_client    m_l_dbclick_border    m_l_dbclick_bkgnd
  5366.  
  5367.     m_c_down_client       m_c_down_border       m_c_down_bkgnd
  5368.     m_c_up_client         m_c_up_border         m_c_up_bkgnd
  5369.     m_c_dbclick_client    m_c_dbclick_border    m_c_dbclick_bkgnd
  5370.  
  5371.     m_r_down_client       m_r_down_border       m_r_down_bkgnd
  5372.     m_r_up_client         m_r_up_border         m_r_up_bkgnd
  5373.     m_r_dbclick_client    m_r_dbclick_border    m_r_dbclick_bkgnd
  5374.  
  5375.  
  5376.   18-5  Defining Menus
  5377.   ────────────────────
  5378.  
  5379.   The Aurora Editor has a fully configurable menu system. It's easy to
  5380.   redefine the menu bars and pull-down menus according to your own
  5381.   preferences for both Edit windows and File Manager windows. You can
  5382.   also redefine the Edit window tool bar to your own preferences.
  5383.  
  5384.   Menu definition macros are stored in the file AMEN.A. You can edit
  5385.   this file by entering the "opena %amen" command or selecting the
  5386.   "Menus.." item from the "Macro" pulldown menu.
  5387.                                                     Defining Menus   102
  5388.  
  5389.  
  5390.   The Menu definitions in AMEN.A are actually source code written in The
  5391.   Aurora Macro Language. They are compiled and included into A.X when
  5392.   the "setres" <Alt-F2> command ("Restore Settings" on the "Set"
  5393.   pull-down menu) is entered.
  5394.  
  5395.   The following function definition in AMEN.A sets the menu bar for all
  5396.   Edit windows:
  5397.  
  5398.     fun EditMen  (
  5399.       winmen @ @ %&File %&Window %&Block %&Search %F&old %&Edit
  5400.                  %&Clip %&Print %Se&t %M&acro %&Help.
  5401.       .
  5402.       .
  5403.     ).
  5404.  
  5405.   In the above function definition, the menu bar items are the "winmen"
  5406.   arguments "%&File" "%&Window", "%&Block", etc. Spaces must separate
  5407.   the menu bar items, and each menu bar item must be preceded by a "%"
  5408.   character, or enclosed in double quotes. Each menu bar item may also
  5409.   contain one ampersand (&) character which indicates that the character
  5410.   which follows is to be highlighted when displayed. To add or remove a
  5411.   menu bar item, just modify the "winmen" statement according to your
  5412.   preferences.
  5413.  
  5414.   To define a pull-down menu, use the "texmen" function. For example,
  5415.   consider the following menu-pulldown definition which creates the
  5416.   "Print" pulldown menu for all Edit windows:
  5417.  
  5418.     texmen  %editPrint
  5419.       " &Print            Alt-P|print"
  5420.       " Print &Block     Ctrl-P|print %m"
  5421.       " Print &Formfeed|prtstr (byte 12)"
  5422.       " Print &Settings..|askprtset".
  5423.  
  5424.   The first argument to the function texmen ("editPrint" in the example
  5425.   above) must be the name of the associated menu bar item prefixed by
  5426.   either "edit" for Edit windows or "fmgr" for File Manager windows.
  5427.   After the first argument, all arguments to "texmen" define a line on
  5428.   the pull-down menu. These arguments have the following format:
  5429.  
  5430.     "display string | macro"
  5431.  
  5432.   The display string may contain one ampersand (&) character to indicate
  5433.   which character is to be highlighted. For example, in the Print
  5434.   pull-down menu example above, the last pull down menu item definition
  5435.   is:
  5436.  
  5437.     " Print &Settings..|askprtset"
  5438.                                                     Defining Menus   103
  5439.  
  5440.  
  5441.   For this menu item, the display string is " Print Settings.." with the
  5442.   "S" highlighted. The macro is "askprtset", which is executed whenever
  5443.   the menu item is selected.
  5444.  
  5445.   To create a "separator line" on a menu, specify "─" as an argument to
  5446.   the "texmen" function.
  5447.  
  5448.   You can use the "mens" command to create "sub-menus". For example,
  5449.   consider the following argument to the texmen function:
  5450.  
  5451.     " Mar&k..              |mens %editMark"
  5452.  
  5453.   This argument will create the menu item " Mar&k..              " and
  5454.   associate it with the command "mens %editMark". When this menu item is
  5455.   selected, the menu "editMark" is displayed. "editMark" must be the
  5456.   name of another pull-down menu created with the "texmen" function.
  5457.  
  5458.   You can modify any menu bar or pull-down definition you wish, except
  5459.   for the first eight lines of the Edit window "Set" pulldown. The
  5460.   Aurora Editor expects these eight menu items to remain the same.
  5461.  
  5462.   When you have completed your changes to the file AMEN.A, save it <F3>,
  5463.   and enter the "setres" <Alt-F2> command ("Restore Settings" on the
  5464.   "Set" pulldown menu). You must exit and re-enter the editor for the
  5465.   new menu definitions to take effect.
  5466.  
  5467.  
  5468.   18-6  The Tool Bar
  5469.   ──────────────────
  5470.  
  5471.   Each Edit window in The Aurora Editor has an optional "Tool Bar" which
  5472.   can be displayed or hidden on demand using the following command from
  5473.   the "Window" pull-down menu:
  5474.  
  5475.   - wtool  "Tool Bar"  <Ctrl-F8>
  5476.  
  5477.     This command displays (or hides) the tool bar on the current Edit
  5478.     window. The tool bar is located underneath the Edit window menu and
  5479.     contains user-definable "controls" which allow easy access to
  5480.     commonly-used commands.
  5481.                                                        The ToolBar   104
  5482.  
  5483.  
  5484.     The default tool bar controls are:
  5485.  
  5486.     <≡> - close the tool bar
  5487.     <?> - tool bar help
  5488.     <*> - display a File Manager window
  5489.     </> - copy the current window
  5490.     <─> - split the current window horizontally
  5491.     <|> - split the current window vertically
  5492.     <o> - display the "Open" prompt
  5493.     <s> - save the file in the current Edit window
  5494.     <F> - display the "Find" prompt
  5495.     <f> - execute the last "Find" or "Replace" command
  5496.     <r> - reflow a block
  5497.     <«> - undo the last change
  5498.     <»> - redo the last change
  5499.     <>> - fold a block
  5500.     <<> - unfold a block
  5501.  
  5502.  
  5503.   The tool bar layout is defined in the file AMEN.A. You can edit this
  5504.   file by entering the "opena %amen" command or selecting the "Menus.."
  5505.   item from the "Macro" pulldown menu.
  5506.  
  5507.   The following function definition in AMEN.A sets the tool bar for all
  5508.   Edit windows:
  5509.  
  5510.     fun EditMen (
  5511.       .
  5512.       .
  5513.       winmen @ 1 %<&&≡> %<&&?> %<&&*> %<&&/> %<&&─> %<&&|> %<&&o> %<&&s>
  5514.                  %<&&F> %<&&f> %<&&r> %<&&«> %<&&»> %<&&>> %<&&<>.
  5515.     ).
  5516.  
  5517.   In the function definition above, the tool bar controls are the
  5518.   "winmen" arguments "%<&&≡>", "%<&&?>", etc. Spaces must separate the
  5519.   tool bar controls and each tool bar control must be preceded by the
  5520.   "%" character, or enclosed in double quotes. Each menu bar item may
  5521.   also contain two back-to-back ampersand (&&) characters which
  5522.   indicates that the character which follows is to be highlighted (with
  5523.   the title bar control color) when displayed . To add, change, or
  5524.   remove a tool bar control, just modify the "winmen" statement
  5525.   according to your preferences.
  5526.  
  5527.   When you define a new tool bar control, you must also define what
  5528.   macro command the tool bar control executes. This is done by adding a
  5529.   tool bar control function to the "edit" object in the file AKBD.A, in
  5530.   the same way that a key definition would be added (see "Defining the
  5531.   Keyboard 18-1). For example:
  5532.                                                        The ToolBar   105
  5533.  
  5534.  
  5535.     obj  edit (
  5536.  
  5537.       // tool bar
  5538.       fun  <*>  (fmgr).               // displays the File Manager
  5539.       fun  <o>  (askopen).            // displays the Open prompt
  5540.       .
  5541.       .
  5542.     ).
  5543.  
  5544.   When you have completed your changes to the file AMEN.A, save it <F3>,
  5545.   and enter the "setres" <Alt-F2> command ("Restore Settings" on the
  5546.   "Set" pulldown menu). You must exit and re-enter the editor for the
  5547.   new menu definitions to take effect.
  5548.  
  5549.  
  5550.   18-7  Text Translation
  5551.   ──────────────────────
  5552.  
  5553.   Text Translation allows you to expand abbreviations and correct
  5554.   commonly misspelled words or typos as you enter characters into the
  5555.   text of an Edit window. You define the words and substitution text in
  5556.   a translation table. You can also define macros that are executed
  5557.   whenever the name of the macro is entered as a word in your text.
  5558.  
  5559.   Text translation definitions are stored in ATRN.A and are actually
  5560.   source code written in The Aurora Macro Language. You can edit ATRN.A
  5561.   by entered the "opena %atrn" <Alt-F5> command. They are compiled and
  5562.   included into A.X when the "setres" <Alt-F2> command ("Restore
  5563.   Settings" on the "Set" pull-down menu) is entered.
  5564.  
  5565.   Text translation can be turned ON and OFF for each Edit window via the
  5566.   "Translate" toggle on the "Set" pull-down menu. When text translation
  5567.   is ON, a "T" appears on the Edit window status line.
  5568.  
  5569.   When Text Translation is ON, the editor will automatically check each
  5570.   "word" you type to see if it exists in a special user-defined
  5571.   translation lookup table in the file ATRN.A. If the word is found, it
  5572.   will be replaced with the substitution text that you have defined in
  5573.   the table. Table lookups are case-sensitive. Consider the following
  5574.   example of a translation table in ATRN.A:
  5575.  
  5576.     // translation table object
  5577.     obj  trn (
  5578.  
  5579.       set
  5580.  
  5581.         // word:          replace with:
  5582.  
  5583.         "adn"             "and"                        ,
  5584.         "teh"             "the"                        ,
  5585.         "asap"            "as soon as possible"        ,
  5586.         "i*"              "I"                          ,
  5587.       .
  5588.     ).
  5589.                                                   Text Translation   106
  5590.  
  5591.  
  5592.   Using the sample table above, if you typed "teh" as a word in an Edit
  5593.   window, it would be replaced immediately with "the". The word "adn"
  5594.   would be replaced with "and", and the word "asap" would be replaced
  5595.   with "as soon as possible".
  5596.  
  5597.   In the examples above, the translations for "teh", "adn", and "asap"
  5598.   are performed as soon as the last character of the word is entered.
  5599.   This can be a problem if the word being translated is also found at
  5600.   the beginning of other words.
  5601.  
  5602.   To prevent translation from occurring until a word delimiter character
  5603.   is entered, define the word with the suffix "*". Using the sample
  5604.   table above, if Text Translation is ON and you enter the word "i", no
  5605.   translation will occur until you enter a word delimiter character
  5606.   after "i" (such as a space, a comma, a period, or the <Enter> key).
  5607.  
  5608.   The translation table can also contain macro language function
  5609.   definitions. These macros will be called when Text Translation is ON
  5610.   and the macro name is entered as a word in your text. For example:
  5611.  
  5612.     // translation table object
  5613.     obj  trn (
  5614.       .
  5615.       .
  5616.       .
  5617.       fun  bip     (beep 800 100).
  5618.       fun  bop*    (beep 100 100).
  5619.     ).
  5620.  
  5621.   Using the sample table above, if Text Translation is ON, and you enter
  5622.   the word "bip", you'll hear a high beep. If you enter the word "bop"
  5623.   followed by a space, you'll hear a low beep (for complete
  5624.   documentation on The Aurora Macro Language, see "The Aurora Macro
  5625.   Language Guide" in AML.DOC)
  5626.  
  5627.   The following configuration settings are associated with Text
  5628.   Translation (see "Configuration Settings" 17-15).
  5629.  
  5630.     TextTran  - text translation ON/OFF default
  5631.     TranObj   - current text translation object
  5632.     TranCSet  - character set defining a word for translation lookup
  5633.  
  5634.   When you have completed your changes to the file ATRN.A, save it <F3>,
  5635.   and enter the "setres" <Alt-F2> command ("Restore Settings" on the
  5636.   "Set" pulldown menu). You must exit and re-enter the editor for the
  5637.   new translation definitions to take effect.
  5638.  
  5639.  
  5640.                                               Command Line Options   107
  5641.  
  5642.  
  5643.   A-1  Command Line Options
  5644.   ─────────────────────────
  5645.  
  5646.   Command Line Options can be specified when loading The Aurora Editor
  5647.   at the DOS prompt. After the "A" or "A3" command, enter a hyphen (-)
  5648.   followed by the option and any option parameters. The following
  5649.   options are available:
  5650.  
  5651.     c - forces the editor to use color attributes
  5652.  
  5653.     m - forces the editor to use monochrome attributes
  5654.  
  5655.     e - executes the macro following the "e" option. The macro is
  5656.         executed after any text or macro files are loaded (see the -x
  5657.         option below). For example:
  5658.  
  5659.           a mydoc.txt -ek_a_e
  5660.  
  5661.         In the above example, the macro "k_a_e" is executed after
  5662.         "mydoc.txt" is loaded. If more than one -e option is specified,
  5663.         only the last specified macro is executed.
  5664.  
  5665.     x - executes the macro filename following the "x" option (there is
  5666.         no space between the "x" and the filename). If you specify
  5667.         multiple "x" options on the same command line, they are executed
  5668.         in the order they are entered. Note that if the "x" option is
  5669.         specified, the default macro file A.X is not automatically
  5670.         executed. For example:
  5671.  
  5672.           C>a -m -xD:\A.X -xD:\TEST.X DOC1.TXT *.TXT
  5673.  
  5674.         In the above example, The Aurora Editor is invoked with
  5675.         monochrome attributes and the macro files D:\A.X and D:\TEST.X
  5676.         are executed. An Edit window is created for DOC1.TXT and a File
  5677.         Manager Window is created for *.TXT.
  5678.  
  5679.                                                   Performance Tips   108
  5680.  
  5681.  
  5682.   B-1  Performance Tips
  5683.   ─────────────────────
  5684.  
  5685.   The Aurora Editor is high performance software. However, the following
  5686.   tips may help you get the utmost in performance:
  5687.  
  5688.   - Use the maximum available conventional memory
  5689.  
  5690.     Configure DOS so that the maximum amount of "conventional" memory
  5691.     (below 1 megabyte) is available. This will decrease the likelihood
  5692.     that the editor will use slower XMS/EMS, or swap to disk.
  5693.  
  5694.   - Use a Disk Cache Program
  5695.  
  5696.     Using a disk caching program such as SMARTDRV can greatly increase
  5697.     overall editor performance. This includes initial loading of the
  5698.     editor, saving and loading of files, executing DOS programs from
  5699.     within the editor, and general virtual memory performance when XMS
  5700.     and EMS are not available.
  5701.  
  5702.   - Use XMS or EMS memory if available
  5703.  
  5704.     Using XMS and/or EMS memory can greatly increase performance when
  5705.     editing large files, and when executing DOS programs from within the
  5706.     editor (see "Configuration - Memory Options" 17-12). Many users may
  5707.     find XMS memory easier to use, since an XMS driver is already
  5708.     installed on many computers (in the form of HIMEM.SYS).
  5709.  
  5710.     When comparing XMS and EMS performance within The Aurora Editor
  5711.     (using the QEMM-386 memory manager), XMS is almost twice as fast as
  5712.     EMS when loading large files. EMS memory is nearly 30% faster than
  5713.     XMS when searching though large files.
  5714.  
  5715.   - Turn off "SaveMac" and "SaveHis"
  5716.  
  5717.     Turning off these two configuration settings can reduce the amount
  5718.     of time it takes to enter and exit the editor. Note that turning off
  5719.     "SaveHis" will prevent the editor from remembering window positions
  5720.     and sizes, cursor positions, etc. across edit sessions.
  5721.  
  5722.